QWebEngineCertificateError Class
QWebEngineCertificateError 类提供有关证书错误的信息。更多
| Header： | #include <QWebEngineCertificateError> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake： | QT += webenginecore |
| 在 QML 中： | webEngineCertificateError |
公共类型
| enum | Type { Ok, SslPinnedKeyNotInCertificateChain, CertificateCommonNameInvalid, CertificateDateInvalid, CertificateAuthorityInvalid, …, CertificateSymantecLegacy } |
属性
|
公共功能
| void | acceptCertificate() |
| QList<QSslCertificate> | certificateChain() const |
| void | defer() |
| QString | description() const |
| bool | isMainFrame() const |
| bool | isOverridable() const |
| void | rejectCertificate() |
| QWebEngineCertificateError::Type | type() const |
| QUrl | url() const |
详细说明
提供有关证书错误的信息。该类用作QWebEnginePage::certificateError() 的参数。
成员类型文档
enum QWebEngineCertificateError::Type
该枚举描述了遇到的证书错误类型。
该枚举类型的值与 Chromium 提供的 SSL 错误相匹配。由于 Qt XML 错误类别无法映射到 Chromium 错误类别，因此不能直接使用QSslError::SslError 值。
| 常量 | 值 | 说明 |
|---|---|---|
QWebEngineCertificateError::Ok | 0 | 没有实际的证书错误。 |
QWebEngineCertificateError::SslPinnedKeyNotInCertificateChain | -150 | 证书与主机名的内置公钥不匹配。 |
QWebEngineCertificateError::CertificateCommonNameInvalid | -200 | 证书通用名与主机名不匹配。 |
QWebEngineCertificateError::CertificateDateInvalid | -201 | 证书在当前日期和时间无效。 |
QWebEngineCertificateError::CertificateAuthorityInvalid | -202 | 证书未由可信机构签署。 |
QWebEngineCertificateError::CertificateContainsErrors | -203 | 证书包含错误。 |
QWebEngineCertificateError::CertificateNoRevocationMechanism | -204 | 证书没有确定是否已被吊销的机制。 |
QWebEngineCertificateError::CertificateUnableToCheckRevocation | -205 | 证书的撤销信息不可用。 |
QWebEngineCertificateError::CertificateRevoked | -206 | 证书已被废止。 |
QWebEngineCertificateError::CertificateInvalid | -207 | 证书无效。 |
QWebEngineCertificateError::CertificateWeakSignatureAlgorithm | -208 | 证书使用弱签名算法签名。 |
QWebEngineCertificateError::CertificateNonUniqueName | -210 | 证书中指定的主机名不唯一。 |
QWebEngineCertificateError::CertificateWeakKey | -211 | 证书包含弱密钥。 |
QWebEngineCertificateError::CertificateNameConstraintViolation | -212 | 证书声称的 DNS 名称违反名称限制。 |
QWebEngineCertificateError::CertificateValidityTooLong (since Qt 5.7) | -213 | 证书有效期过长。 |
QWebEngineCertificateError::CertificateTransparencyRequired (since Qt 5.8) | -214 | 此连接要求证书透明，但服务器未提供符合政策的 CT 信息。 |
QWebEngineCertificateError::CertificateKnownInterceptionBlocked (since Qt 5.15) | -217 | 已知证书被设备所有者以外的实体用于拦截。 |
QWebEngineCertificateError::SslObsoleteVersion (since Qt 6.2, deprecated in Qt 6.4) | -218 | 连接使用的是过时版本的 SSL/TLS。 |
QWebEngineCertificateError::CertificateSymantecLegacy (since Qt 6.2, deprecated in Qt 6.11) | -215 | 该证书是赛门铁克的传统证书，已失效。 |
属性文档
[read-only] description : const QString
该属性包含对错误的简短本地化人可读描述。
访问功能：
| QString | description() const |
另请参阅 url() 和isOverridable()。
[read-only, since 6.8] isMainFrame : const bool
返回证书错误是否来自主框架。如果为 false，则错误来自子资源，很可能需要在没有用户输入的情况下予以拒绝。
此属性在 Qt 6.8 中引入。
访问函数：
| bool | isMainFrame() const |
[read-only] overridable : const bool
此属性表示是否可以重载和接受此错误。
访问函数：
| bool | isOverridable() const |
另请参见 description().
[read-only] type : const Type
该属性用于保存错误类型。
访问函数：
| QWebEngineCertificateError::Type | type() const |
另请参阅 description() 和isOverridable()。
[read-only] url : const QUrl
该属性包含引发错误的 URL。
访问功能：
| QUrl | url() const |
另请参阅 description().
成员函数文档
[invokable] void QWebEngineCertificateError::acceptCertificate()
接受证书并继续加载请求的 URL。
注： 可通过元对象系统和 QML 调用该函数。请参阅Q_INVOKABLE 。
QList<QSslCertificate> QWebEngineCertificateError::certificateChain() const
返回同行的数字证书链。
链以对等方的直接证书开始，以 CA 的证书结束。
[invokable] void QWebEngineCertificateError::defer()
标记证书错误，以便延迟处理。
当需要推迟决定是否接受证书时，例如等待用户输入时，应调用此函数。调用该函数时，URL 请求会暂停，直到acceptCertificate() 或rejectCertificate() 被调用。
注： 只能推迟可覆盖的证书错误。
注： 可通过元对象系统和 QML 调用该函数。请参阅Q_INVOKABLE 。
另请参阅 isOverridable() 。
[invokable] void QWebEngineCertificateError::rejectCertificate()
拒绝证书并中止加载请求的 URL。
注： 可通过元对象系统和 QML 调用该函数。请参阅Q_INVOKABLE 。
© 2026 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.
