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.

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().

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.

© 2023 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.