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 operation 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.

© 2024 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.