QWebEngineCertificateError Class

The QWebEngineCertificateError class provides information about a certificate error. 更多...

头：	#include <QWebEngineCertificateError>
qmake:	QT += webenginewidgets
Since:	Qt 5.4

该类在 Qt 5.4 引入。

所有成员列表，包括继承成员

公共类型

enum	Error { SslPinnedKeyNotInCertificateChain, CertificateCommonNameInvalid, CertificateDateInvalid, CertificateAuthorityInvalid, CertificateContainsErrors, …, CertificateKnownInterceptionBlocked }

公共函数

bool	answered () const
QList<QSslCertificate>	certificateChain () const
void	defer ()
bool	deferred () const
QWebEngineCertificateError::Error	error () const
QString	errorDescription () const
void	ignoreCertificateError ()
bool	isOverridable () const
void	rejectCertificate ()
QUrl	url () const

详细描述

Provides information about a certificate error. This class is used as a parameter of QWebEnginePage::certificateError ().

成员类型文档编制

enum QWebEngineCertificateError:: Error

This enum describes the type of certificate error encountered.

The values of this enum type match the SSL errors Chromium provides. QSslError::SslError values are not used directly, because the Qt error categories cannot be mapped to the Chromium error categories.

常量	值	描述
`QWebEngineCertificateError::SslPinnedKeyNotInCertificateChain`	`-150`	The certificate did not match the built-in public keys pinned for the host name.
`QWebEngineCertificateError::CertificateCommonNameInvalid`	`-200`	The certificate's common name did not match the host name.
`QWebEngineCertificateError::CertificateDateInvalid`	`-201`	The certificate is not valid at the current date and time.
`QWebEngineCertificateError::CertificateAuthorityInvalid`	`-202`	The certificate is not signed by a trusted authority.
`QWebEngineCertificateError::CertificateContainsErrors`	`-203`	The certificate contains errors.
`QWebEngineCertificateError::CertificateNoRevocationMechanism`	`-204`	The certificate has no mechanism for determining if it has been revoked.
`QWebEngineCertificateError::CertificateUnableToCheckRevocation`	`-205`	Revocation information for the certificate is not available.
`QWebEngineCertificateError::CertificateRevoked`	`-206`	The certificate has been revoked.
`QWebEngineCertificateError::CertificateInvalid`	`-207`	The certificate is invalid.
`QWebEngineCertificateError::CertificateWeakSignatureAlgorithm`	`-208`	The certificate is signed using a weak signature algorithm.
`QWebEngineCertificateError::CertificateNonUniqueName`	`-210`	The host name specified in the certificate is not unique.
`QWebEngineCertificateError::CertificateWeakKey`	`-211`	The certificate contains a weak key.
`QWebEngineCertificateError::CertificateNameConstraintViolation`	`-212`	The certificate claimed DNS names that are in violation of name constraints.
`QWebEngineCertificateError::CertificateValidityTooLong`	`-213`	The certificate has a validity period that is too long. (Added in Qt 5.7)
`QWebEngineCertificateError::CertificateTransparencyRequired`	`-214`	Certificate Transparency was required for this connection, but the server did not provide CT information that complied with the policy. (Added in Qt 5.8)
`QWebEngineCertificateError::CertificateKnownInterceptionBlocked`	`-217`	The certificate is known to be used for interception by an entity other the device owner. (Added in 5.15)

成员函数文档编制

bool QWebEngineCertificateError:: answered () const

返回 true if the error was explicitly rejected or ignored.

该函数在 Qt 5.14 引入。

QList < QSslCertificate > QWebEngineCertificateError:: certificateChain () const

Returns the peer's chain of digital certificates.

Chain starts with the peer's immediate certificate and ending with the CA's certificate.

该函数在 Qt 5.14 引入。

void QWebEngineCertificateError:: defer ()

Marks the certificate error for delayed handling.

This function should be called when there is a need to postpone the decision whether to ignore a certificate error, for example, while waiting for user input. When called, the function pauses the URL request until ignoreCertificateError () 或 rejectCertificate () 被调用。

注意： It is only possible to defer overridable certificate errors.

该函数在 Qt 5.14 引入。

另请参阅 isOverridable () 和 deferred ().

bool QWebEngineCertificateError:: deferred () const

Returns whether the decision for error handling was delayed and the URL load was halted.

该函数在 Qt 5.14 引入。

QWebEngineCertificateError::Error QWebEngineCertificateError:: error () const

Returns the type of the error.

另请参阅 errorDescription () 和 isOverridable ().

QString QWebEngineCertificateError:: errorDescription () const

Returns a short localized human-readable description of the error.

另请参阅 error (), url ()，和 isOverridable ().

void QWebEngineCertificateError:: ignoreCertificateError ()

Ignores the certificate error and continues the loading of the requested URL.

该函数在 Qt 5.14 引入。

bool QWebEngineCertificateError:: isOverridable () const

Returns whether this error can be overridden and accepted.

另请参阅 error () 和 errorDescription ().

void QWebEngineCertificateError:: rejectCertificate ()

Rejects the certificate and aborts the loading of the requested URL.

该函数在 Qt 5.14 引入。

QUrl QWebEngineCertificateError:: url () const

Returns the URL that triggered the error.

另请参阅 error () 和 errorDescription ().