IXpsSignature::Verify-Methode (xpsdigitalsignature.h)
Überprüft die Signatur anhand eines angegebenen X.509-Zertifikats.
Syntax
HRESULT Verify(
[in] const CERT_CONTEXT *x509Certificate,
[out, retval] XPS_SIGNATURE_STATUS *sigStatus
);
Parameter
[in] x509Certificate
Die CERT_CONTEXT Struktur, die das X.509-Zertifikat enthält, das für die Überprüfung verwendet wird.
Wenn die Signatur nicht unvollständig oder inkompatibel ist, wird dieses Zertifikat nur verwendet, um zu überprüfen, ob die signierten Daten im XPS-Paket intakt sind. Das Zertifikat wird nicht verwendet, um andere Überprüfungen durchzuführen. Vor der Verwendung des Zertifikats wird erwartet, dass die Anwendung die Vertrauenskette und alle anderen Anforderungen überprüft.
[out, retval] sigStatus
Der XPS_SIGNATURE_STATUS Wert, der die Ergebnisse der Überprüfung beschreibt.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem diejenigen in der folgenden Tabelle. Rückgabewerte, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS Digital Signature-API-Fehler und XPS-Dokumentfehler.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
x509Certificate oder sigStatus ist NULL. |
|
Die Schnittstelle ist nicht mit dem Signatur-Manager verbunden. |
Hinweise
Diese Methode erkennt die Signatur status in der Reihenfolge, die in Abschnitt 10.2.1.2 der XML-Papierspezifikation angegeben ist. Die Sequenz der Erkennung ist wie folgt: inkompatibel, unvollständig, beschädigt, fragwürdig und schließlich gültig. Dies bedeutet, dass, wenn z. B. eine Signatur als inkompatibel eingestuft wird, kein Digest berechnet wird, wenn die Signatur ebenfalls beschädigt ist.
Weitere Informationen zu den verschiedenen Arten von Signaturstatus, die von dieser Methode erkannt werden können, finden Sie unter XPS_SIGNATURE_STATUS.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | xpsdigitalsignature.h |