QWebEngineCertificateError Class
Die Klasse QWebEngineCertificateError liefert Informationen über einen Zertifikatsfehler. Mehr...
| Kopfzeile: | #include <QWebEngineCertificateError> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
| In QML: | webEngineCertificateError |
Öffentliche Typen
| enum | Type { Ok, SslPinnedKeyNotInCertificateChain, CertificateCommonNameInvalid, CertificateDateInvalid, CertificateAuthorityInvalid, …, CertificateSymantecLegacy } |
Eigenschaften
|
Öffentliche Funktionen
| 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 |
Detaillierte Beschreibung
Liefert Informationen über einen Zertifikatsfehler. Diese Klasse wird als Parameter von QWebEnginePage::certificateError() verwendet.
Dokumentation der Mitgliedstypen
enum QWebEngineCertificateError::Type
Diese Aufzählung beschreibt den Typ des aufgetretenen Zertifikatsfehlers.
Die Werte dieses Enum-Typs entsprechen den SSL-Fehlern, die Chromium bereitstellt. QSslError::SslError Werte werden nicht direkt verwendet, da die Qt-Fehlerkategorien nicht auf die Chromium-Fehlerkategorien abgebildet werden können.
| Konstante | Wert | Beschreibung |
|---|---|---|
QWebEngineCertificateError::Ok | 0 | Es lag kein aktueller Zertifikatsfehler vor. |
QWebEngineCertificateError::SslPinnedKeyNotInCertificateChain | -150 | Das Zertifikat stimmte nicht mit den eingebauten öffentlichen Schlüsseln überein, die für den Hostnamen hinterlegt sind. |
QWebEngineCertificateError::CertificateCommonNameInvalid | -200 | Der Common Name des Zertifikats stimmte nicht mit dem Hostnamen überein. |
QWebEngineCertificateError::CertificateDateInvalid | -201 | Das Zertifikat ist zum aktuellen Datum und Zeitpunkt nicht gültig. |
QWebEngineCertificateError::CertificateAuthorityInvalid | -202 | Das Zertifikat ist nicht von einer vertrauenswürdigen Stelle signiert. |
QWebEngineCertificateError::CertificateContainsErrors | -203 | Das Zertifikat enthält Fehler. |
QWebEngineCertificateError::CertificateNoRevocationMechanism | -204 | Das Zertifikat verfügt über keinen Mechanismus, um festzustellen, ob es widerrufen wurde. |
QWebEngineCertificateError::CertificateUnableToCheckRevocation | -205 | Es sind keine Widerrufsinformationen für das Zertifikat verfügbar. |
QWebEngineCertificateError::CertificateRevoked | -206 | Das Zertifikat wurde widerrufen. |
QWebEngineCertificateError::CertificateInvalid | -207 | Das Zertifikat ist ungültig. |
QWebEngineCertificateError::CertificateWeakSignatureAlgorithm | -208 | Das Zertifikat wurde mit einem schwachen Signaturalgorithmus signiert. |
QWebEngineCertificateError::CertificateNonUniqueName | -210 | Der im Zertifikat angegebene Hostname ist nicht eindeutig. |
QWebEngineCertificateError::CertificateWeakKey | -211 | Das Zertifikat enthält einen schwachen Schlüssel. |
QWebEngineCertificateError::CertificateNameConstraintViolation | -212 | Das Zertifikat beansprucht DNS-Namen, die gegen die Namensbeschränkungen verstoßen. |
QWebEngineCertificateError::CertificateValidityTooLong (since Qt 5.7) | -213 | Das Zertifikat hat eine zu lange Gültigkeitsdauer. |
QWebEngineCertificateError::CertificateTransparencyRequired (since Qt 5.8) | -214 | Für diese Verbindung war Zertifikatstransparenz erforderlich, aber der Server hat keine CT-Informationen bereitgestellt, die der Richtlinie entsprechen. |
QWebEngineCertificateError::CertificateKnownInterceptionBlocked (since Qt 5.15) | -217 | Es ist bekannt, dass das Zertifikat von einer anderen Entität als dem Eigentümer des Geräts zum Abfangen verwendet wird. |
QWebEngineCertificateError::SslObsoleteVersion (since Qt 6.2, deprecated in Qt 6.4) | -218 | Die Verbindung verwendet eine veraltete Version von SSL/TLS. |
QWebEngineCertificateError::CertificateSymantecLegacy (since Qt 6.2, deprecated in Qt 6.11) | -215 | Das Zertifikat ist ein altes Symantec-Zertifikat, das nicht mehr gültig ist. |
Dokumentation der Eigenschaft
[read-only] description : const QString
Diese Eigenschaft enthält eine kurze, lokalisierte und von Menschen lesbare Beschreibung des Fehlers.
Zugriffsfunktionen:
| QString | description() const |
Siehe auch url() und isOverridable().
[read-only, since 6.8] isMainFrame : const bool
Gibt zurück, ob der Zertifikatsfehler aus dem Hauptrahmen stammt. Falls false, stammt der Fehler von einer Sub-Ressource und muss höchstwahrscheinlich ohne Benutzereingabe zurückgewiesen werden.
Diese Eigenschaft wurde in Qt 6.8 eingeführt.
Zugriffsfunktionen:
| bool | isMainFrame() const |
[read-only] overridable : const bool
Diese Eigenschaft gibt an, ob dieser Fehler außer Kraft gesetzt und akzeptiert werden kann.
Zugriffsfunktionen:
| bool | isOverridable() const |
Siehe auch description().
[read-only] type : const Type
Diese Eigenschaft enthält den Typ des Fehlers.
Zugriffsfunktionen:
| QWebEngineCertificateError::Type | type() const |
Siehe auch description() und isOverridable().
[read-only] url : const QUrl
Diese Eigenschaft enthält die URL, die den Fehler ausgelöst hat.
Zugriffsfunktionen:
| QUrl | url() const |
Siehe auch description().
Dokumentation der Mitgliedsfunktionen
[invokable] void QWebEngineCertificateError::acceptCertificate()
Akzeptiert das Zertifikat und setzt das Laden der angeforderten URL fort.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
QList<QSslCertificate> QWebEngineCertificateError::certificateChain() const
Gibt die Kette der digitalen Zertifikate der Gegenstelle zurück.
Die Kette beginnt mit dem unmittelbaren Zertifikat der Gegenstelle und endet mit dem Zertifikat der CA.
[invokable] void QWebEngineCertificateError::defer()
Markiert den Zertifikatsfehler für eine verzögerte Behandlung.
Diese Funktion sollte aufgerufen werden, wenn die Entscheidung, ob ein Zertifikat akzeptiert werden soll, aufgeschoben werden muss, z. B. beim Warten auf Benutzereingaben. Wenn die Funktion aufgerufen wird, hält sie die URL-Anfrage an, bis acceptCertificate() oder rejectCertificate() aufgerufen wird.
Hinweis: Es ist nur möglich, überschreibbare Zertifikatsfehler aufzuschieben.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch isOverridable().
[invokable] void QWebEngineCertificateError::rejectCertificate()
Lehnt das Zertifikat ab und bricht das Laden der angeforderten URL ab.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe 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.
