SslCreateHandshakeHash-Funktion

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 der SSL-Protokollanbieterinstanz (Secure Sockets Layer Protocol).

phHandshakeHash [ out]

Ein Hashhandle, das an andere SSL-Anbieterfunktionen übergeben werden kann.

dwProtocol [ In]

Einer der CNG SSL Provider Protocol Identifier-Werte.

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 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 _ NO _ MEMORY
0x8009000EL
Es ist nicht genügend Arbeitsspeicher zum Zuordnen des Hashpuffers vorhanden.
NTE _ UNGÜLTIGES _ 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 verwendet werden, um einen Hash zu generieren, der während des SSL-Handshakes verwendet wird.

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

Requirements (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