SslCreateHandshakeHash-Funktion

Artikel
06/12/2023

Die SslCreateHandshakeHash-Funktion ruft ein Hashhandle ab, das zum Hashen von Handshakenachrichten verwendet wird.

Syntax

SECURITY_STATUS WINAPI SslCreateHandshakeHash(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _Out_ NCRYPT_HASH_HANDLE *phHandshakeHash,
  _In_  DWORD              dwProtocol,
  _In_  DWORD              dwCipherSuite,
  _In_  DWORD              dwFlags
);

Parameter

hSslProvider [in]: Das Handle des SSL-Protokollanbieters (Secure Sockets Layer Protocol) instance.
phHandshakeHash [out]: Ein Hashhandle, das an andere SSL-Anbieterfunktionen übergeben werden kann.
dwProtocol [in]: Einer der Werte des CNG-SSL-Anbieterprotokoll-Bezeichners .

Hinweis

Diese Funktion wird nicht mit dem SSL 2.0-Protokoll verwendet.
dwCipherSuite [in]: Einer der CNG SSL Provider Cipher Suite Identifier-Werte .
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, gibt sie einen fehlerfreien Wert zurück.

Mögliche Rückgabecodes umfassen folgendes, sind aber nicht darauf beschränkt.

Rückgabecode/-wert	Beschreibung
NTE_NO_MEMORY 0x8009000EL	Es ist nicht genügend Arbeitsspeicher vorhanden, um den Hashpuffer zuzuordnen.
NTE_INVALID_HANDLE 0x80090026L	Das hSslProvider-Handle ist ungültig.
NTE_INVALID_PARAMETER 0x80090027L	PhHandshakeHash ist NULL.

Bemerkungen

Die SslCreateHandshakeHash-Funktion ist eine von drei Funktionen, die zum Generieren eines Hashs verwendet werden, der während des SSL-Handshakes verwendet werden soll.

Die SslCreateHandshakeHash-Funktion wird aufgerufen, um ein Hashhandle abzurufen.
Die SslHashHandshake-Funktion wird beliebig oft mit dem Hashhandle aufgerufen, um dem HashDaten hinzuzufügen.
Die SslComputeFinishedHash-Funktion wird mit dem Hashhandle aufgerufen, um den Digest der Hashdaten abzurufen.

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