SslVerifySignature-Funktion
Die SslVerifySignature-Funktion überprüft die angegebene Signatur mithilfe des angegebenen Hashs und des öffentlichen Schlüssels.
Syntax
SECURITY_STATUS WINAPI SslVerifySignature(
_In_ NCRYPT_PROV_HANDLE hSslProvider,
_In_ NCRYPT_KEY_HANDLE hPublicKey,
_In_ PBYTE pbHashValue,
_In_ DWORD cbHashValue,
_In_ PBYTE pbSignature,
_In_ DWORD cbSignature,
_In_ DWORD dwFlags
);
Parameter
-
hSslProvider [ In]
-
Das Handle für die SSL-Protokollanbieterinstanz (Secure Sockets Layer Protocol).
-
hPublicKey [ In]
-
Das Handle für den öffentlichen Schlüssel.
-
pbHashValue [ In]
-
Ein Zeiger auf einen Puffer, der den Hash enthält, der zum Überprüfen der Signatur verwendet werden soll.
-
cbHashValue [ In]
-
Die Größe des pbHashValue-Puffers in Bytes.
-
pbSignature [ In]
-
Ein Zeiger auf einen Puffer, der die zu überprüfende Signatur enthält.
-
cbSignature [ In]
-
Die Größe des pbSignature-Puffers in Bytes.
-
dwFlags [ In]
-
Dieser Parameter ist für die zukünftige Verwendung reserviert.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie 0 (null) zurück.
Wenn die Funktion fehlschlägt, wird ein Fehlerwert ungleich 0 (null) zurückgegeben.
Mögliche Rückgabecodes sind u. a. folgende.
| Rückgabecode/-wert | Beschreibung |
|---|---|
|
Einer der bereitgestellten Handles ist ungültig. |
Hinweise
Die SslVerifySignature-Funktion wird derzeit nicht von Windows aufgerufen. Diese Funktion ist ein erforderlicher Teil der SSL-Anbieterschnittstelle und sollte vollständig implementiert werden, um die Vorwärtskompatibilität sicherzustellen.
Aktuelle Implementierungen der Serverseite der TLS-Verbindung (Transport Layer Security Protocol) rufen die NCryptVerifySignature-Funktion während der Clientauthentifizierung auf, um die Zertifikatüberprüfungsmeldung zu verarbeiten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows [Nur Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2008-Desktop-Apps] |
| Header |
|
| DLL |
|