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]

Einer der CNG SSL Provider Protocol Identifier-Werte.

dwCipherSuite [ In]

Einer der CNG SSL Provider Cipher Suite Identifier-Werte.

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
NTE _ UNGÜLTIGES _ HANDLE
0x80090026L
Der hSslProvider-Parameter enthält einen ungültigen Zeiger.
NTE _ UNGÜLTIGER _ PARAMETER
0x80090027L
Der phHandshakeHash-Parameter ist auf NULL festgelegt.
NTE _ NICHT _ UNTERSTÜTZT
0x80090029L
Die ausgewählte Funktion wird in der angegebenen Version der -Schnittstelle nicht unterstützt.
NTE _ NO _ MEMORY
0x8009000EL
Nicht genügend Arbeitsspeicher zum Zuordnen von Puffern.
NTE _ BAD _ FLAGS
0x80090009L
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
Sslprovider.h
DLL
Ncrypt.dll