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]
-
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 |
|---|---|
|
Es ist nicht genügend Arbeitsspeicher zum Zuordnen des Hashpuffers vorhanden. |
|
Das hSslProvider-Handle ist ungültig. |
|
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.
- Die SslCreateHandshakeHash-Funktion wird aufgerufen, um ein Hashhandle abzurufen.
- Die SslHashHandshake-Funktion wird beliebig oft mit dem Hashhandle aufgerufen, um dem Hash Daten hinzuzufügen.
- 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 |
|
| DLL |
|