- Qt 6.8
- Qt Network
- C++ Classes
- QSslError
- Qt 6.8.0 Reference Documentation

# QSslError Class

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

Header: | #include <QSslError>
CMake: | find_package(Qt6 REQUIRED COMPONENTS Network) target_link_libraries(mytarget PRIVATE Qt6::Network)
qmake: | QT += network

- List of all members, including inherited members
- QSslError is part of Network Programming API and Implicitly Shared Classes.

Note: All functions in this class are reentrant.

## Public Types

enum | SslError { NoError, UnableToGetIssuerCertificate, UnableToDecryptCertificateSignature, UnableToDecodeIssuerPublicKey, CertificateSignatureFailed, …, OcspStatusUnknown }

## Public Functions

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

## Detailed Description

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`
`QSslError::CertificateStatusUnknown` | `25`
`QSslError::OcspNoResponseFound` | `26`
`QSslError::OcspMalformedRequest` | `27`
`QSslError::OcspMalformedResponse` | `28`
`QSslError::OcspInternalError` | `29`
`QSslError::OcspTryLater` | `30`
`QSslError::OcspSigRequred` | `31`
`QSslError::OcspUnauthorized` | `32`
`QSslError::OcspResponseCannotBeTrusted` | `33`
`QSslError::OcspResponseCertIdUnknown` | `34`
`QSslError::OcspResponseExpired` | `35`
`QSslError::OcspStatusUnknown` | `36`

See also QSslError::errorString().

## Member Function Documentation

### QSslError::QSslError()

Constructs a QSslError object with no error and default certificate.

### `[explicit]` QSslError::QSslError(QSslError::SslError error)

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

### QSslError::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.

### `[noexcept]` 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().

### QSslError::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().

### `[noexcept]` void QSslError::swap(QSslError &other)

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

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

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

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

Assigns the contents of other to this error.

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

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