SslVerifySignature-Funktion

Artikel
06/12/2023

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 den SSL-Protokollanbieter (Secure Sockets Layer Protocol) instance.
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 null zurück.

Wenn die Funktion fehlschlägt, wird ein Fehlerwert ungleich null zurückgegeben.

Mögliche Rückgabecodes sind u. a. die folgenden:

Rückgabecode/-wert	Beschreibung
NTE_INVALID_HANDLE 0x80090026L	Einer der bereitgestellten Handles ist ungültig.

Bemerkungen

Die SslVerifySignature-Funktion wird derzeit nicht von Windows aufgerufen. Diese Funktion ist ein erforderlicher Bestandteil 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 Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Header	Sslprovider.h
DLL	Ncrypt.dll

Freigeben über