Qt 5.6 | Qt Network | C++ Classes | QSslError

Qt 5.6.2 Reference Documentation

# QSslError Class

The QSslError class provides an SSL error. More...

Header: | #include <QSslError>
qmake: | QT += network
Since: | Qt 4.3

- List of all members, including inherited members

Note: All functions in this class are reentrant.

## Public Types

enum | SslError { NoError, UnableToGetIssuerCertificate, UnableToDecryptCertificateSignature, UnableToDecodeIssuerPublicKey, ..., CertificateBlacklisted }

## Public Functions

| QSslError()
| QSslError(SslError error)
| QSslError(SslError error, const QSslCertificate &certificate)
| QSslError(const QSslError &other)
| ~QSslError()
QSslCertificate | certificate() const
SslError | error() const
QString | errorString() const
void | swap(QSslError &other)
bool | operator!=(const QSslError &other) const
QSslError & | operator=(QSslError &&other)
QSslError & | operator=(const QSslError &other)
bool | operator==(const QSslError &other) const

## Detailed Description

The QSslError class provides an SSL error.

QSslError provides a simple API for managing errors during QSslSocket's SSL handshake.

See also QSslSocket, QSslCertificate, and QSslCipher.

## Member Type Documentation

### enum QSslError::SslError

Describes all recognized errors that can occur during an SSL handshake.

Constant | Value
--- | ---
`QSslError::NoError` | `0`
`QSslError::UnableToGetIssuerCertificate` | `1`
`QSslError::UnableToDecryptCertificateSignature` | `2`
`QSslError::UnableToDecodeIssuerPublicKey` | `3`
`QSslError::CertificateSignatureFailed` | `4`
`QSslError::CertificateNotYetValid` | `5`
`QSslError::CertificateExpired` | `6`
`QSslError::InvalidNotBeforeField` | `7`
`QSslError::InvalidNotAfterField` | `8`
`QSslError::SelfSignedCertificate` | `9`
`QSslError::SelfSignedCertificateInChain` | `10`
`QSslError::UnableToGetLocalIssuerCertificate` | `11`
`QSslError::UnableToVerifyFirstCertificate` | `12`
`QSslError::CertificateRevoked` | `13`
`QSslError::InvalidCaCertificate` | `14`
`QSslError::PathLengthExceeded` | `15`
`QSslError::InvalidPurpose` | `16`
`QSslError::CertificateUntrusted` | `17`
`QSslError::CertificateRejected` | `18`
`QSslError::SubjectIssuerMismatch` | `19`
`QSslError::AuthorityIssuerSerialNumberMismatch` | `20`
`QSslError::NoPeerCertificate` | `21`
`QSslError::HostNameMismatch` | `22`
`QSslError::UnspecifiedError` | `-1`
`QSslError::NoSslSupport` | `23`
`QSslError::CertificateBlacklisted` | `24`

See also QSslError::errorString().

## Member Function Documentation

### QSslError::QSslError()

Constructs a QSslError object with no error and default certificate.

### QSslError::QSslError(SslError error)

Constructs a QSslError object. The argument specifies the error that occurred.

### QSslError::QSslError(SslError error, const QSslCertificate &certificate)

Constructs a QSslError object. The two arguments specify the error that occurred, and which certificate the error relates to.

See also QSslCertificate.

### QSslError::QSslError(const QSslError &other)

Constructs an identical copy of other.

### QSslError::~QSslError()

Destroys the QSslError object.

### QSslCertificate QSslError::certificate() const

Returns the certificate associated with this error, or a null certificate if the error does not relate to any certificate.

See also error() and errorString().

### SslError QSslError::error() const

Returns the type of the error.

See also errorString() and certificate().

### QString QSslError::errorString() const

Returns a short localized human-readable description of the error.

See also error() and certificate().

### void QSslError::swap(QSslError &other)

Swaps this error instance with other. This function is very fast and never fails.

This function was introduced in Qt 5.0.

### bool QSslError::operator!=(const QSslError &other) const

Returns `true` if this error is not equal to other; otherwise returns false.

This function was introduced in Qt 4.4.

### QSslError &QSslError::operator=(QSslError &&other)

Move-assignment operator.

### QSslError &QSslError::operator=(const QSslError &other)

Assigns the contents of other to this error.

This function was introduced in Qt 4.4.

### bool QSslError::operator==(const QSslError &other) const

Returns `true` if this error is equal to other; otherwise returns `false`.

This function was introduced in Qt 4.4.