QSslError Class

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

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

List of all members, including inherited members

Note: All functions in this class are reentrant.

Public Types

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

Public Functions

	QSslError(const QSslError &other)
	QSslError(QSslError::SslError error, const QSslCertificate &certificate)
	QSslError(QSslError::SslError error)
	QSslError()
QSslError &	operator=(const QSslError &other)
	~QSslError()
QSslCertificate	certificate() const
QSslError::SslError	error() const
QString	errorString() const
void	swap(QSslError &other)
bool	operator!=(const QSslError &other) const
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(const QSslError &other)

Constructs an identical copy of other.

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(QSslError::SslError error)

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

QSslError::QSslError()

Constructs a QSslError object with no error and default certificate.

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

Assigns the contents of other to this error.

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

`[since 5.0]` 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.

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

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

Contents