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
NTE _ UNGÜLTIGES _ HANDLE
0x80090026L
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
Sslprovider.h
DLL
Ncrypt.dll