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

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.

ConstantValue
QSslError::NoError0
QSslError::UnableToGetIssuerCertificate1
QSslError::UnableToDecryptCertificateSignature2
QSslError::UnableToDecodeIssuerPublicKey3
QSslError::CertificateSignatureFailed4
QSslError::CertificateNotYetValid5
QSslError::CertificateExpired6
QSslError::InvalidNotBeforeField7
QSslError::InvalidNotAfterField8
QSslError::SelfSignedCertificate9
QSslError::SelfSignedCertificateInChain10
QSslError::UnableToGetLocalIssuerCertificate11
QSslError::UnableToVerifyFirstCertificate12
QSslError::CertificateRevoked13
QSslError::InvalidCaCertificate14
QSslError::PathLengthExceeded15
QSslError::InvalidPurpose16
QSslError::CertificateUntrusted17
QSslError::CertificateRejected18
QSslError::SubjectIssuerMismatch19
QSslError::AuthorityIssuerSerialNumberMismatch20
QSslError::NoPeerCertificate21
QSslError::HostNameMismatch22
QSslError::UnspecifiedError-1
QSslError::NoSslSupport23
QSslError::CertificateBlacklisted24
QSslError::CertificateStatusUnknown25
QSslError::OcspNoResponseFound26
QSslError::OcspMalformedRequest27
QSslError::OcspMalformedResponse28
QSslError::OcspInternalError29
QSslError::OcspTryLater30
QSslError::OcspSigRequred31
QSslError::OcspUnauthorized32
QSslError::OcspResponseCannotBeTrusted33
QSslError::OcspResponseCertIdUnknown34
QSslError::OcspResponseExpired35
QSslError::OcspStatusUnknown36

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.