SslCreateClientAuthHash-Funktion
Die SslCreateClientAuthHash-Funktion ruft ein Handle für den Handshakehash ab, der für die Clientauthentifizierung verwendet wird.
Syntax
SECURITY_STATUS WINAPI SslCreateClientAuthHash(
_In_ NCRYPT_PROV_HANDLE hSslProvider,
_Out_ NCRYPT_HASH_HANDLE *phHandshakeHash,
_In_ DWORD dwProtocol,
_In_ DWORD dwCipherSuite,
_In_ LPCWSTR pszHashAlgId,
_In_ DWORD dwFlags
);
Parameter
-
hSslProvider [ In]
-
Das Handle der SSL-Secure Sockets Layer (Protokollanbieterinstanz).
-
phHandshakeHash [ out]
-
Ein Zeiger auf eine NCRYPT _ HASH _ HANDLE-Variable, um das Hashhand handle zu empfangen.
-
dwProtocol [ In]
-
dwCipherSuite [ In]
-
pszHashAlgId [ In]
-
Einer der CNG-Algorithmusbezeichnerwerte.
-
dwFlags [ In]
-
Dieser Parameter ist für die zukünftige Verwendung reserviert und muss auf 0 (null) festgelegt werden.
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 |
|---|---|
|
Der hSslProvider-Parameter enthält einen ungültigen Zeiger. |
|
Der phHandshakeHash-Parameter ist auf NULL festgelegt. |
|
Die ausgewählte Funktion wird in der angegebenen Version der -Schnittstelle nicht unterstützt. |
|
Nicht genügend Arbeitsspeicher zum Zuordnen von Puffern. |
|
Der dwFlags-Parameter muss auf 0 (null) festgelegt werden. |
Bemerkungen
Die SslCreateClientAuthHash-Funktion wird für TLS 1.2-Konversationen (Transport Layer Security Protocol) oder höher aufgerufen, um Hashobjekte zu erstellen, die zum Hashen von Handshakenachrichten verwendet werden. Sie wird einmal für jeden möglichen Hashalgorithmus aufgerufen, der in der Clientauthentifizierungssignatur verwendet werden kann.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 7 [ Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server 2008 [ R2-Desktop-Apps] |
| Header |
|
| DLL |
|