SslCreateClientAuthHash-Funktion

Artikel
13.06.2023

Die SslCreateClientAuthHash-Funktion ruft ein Handle für den Handshake-Hash 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 des SSL-Protokollanbieters (Secure Sockets Layer Protocol) instance.
phHandshakeHash [out]: Ein Zeiger auf eine NCRYPT_HASH_HANDLE Variable, die das Hashhandle empfangen soll.
dwProtocol [in]: Einer der Werte des CNG-SSL-Anbieterprotokollbezeichners .
dwCipherSuite [in]: Einer der CNG SSL Provider Cipher Suite Identifier-Werte .
pszHashAlgId [in]: Einer der Werte für CNG-Algorithmusbezeichner .
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 null zurück.

Wenn die Funktion fehlschlägt, wird ein Fehlerwert ungleich null zurückgegeben.

Mögliche Rückgabecodes sind u. a. die folgenden:

Rückgabecode/-wert	BESCHREIBUNG
NTE_INVALID_HANDLE 0x80090026L	Der Parameter hSslProvider enthält einen ungültigen Zeiger.
NTE_INVALID_PARAMETER 0x80090027L	Der parameter phHandshakeHash ist auf NULL festgelegt.
NTE_NOT_SUPPORTED 0x80090029L	Die ausgewählte Funktion wird in der angegebenen Version der Schnittstelle nicht unterstützt.
NTE_NO_MEMORY 0x8009000EL	Unzureichender Arbeitsspeicher zum Zuweisen 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-Unterhaltungen ( Transport Layer Security Protocol ) oder höher aufgerufen, um Hashobjekte zu erstellen, die zum Hashen von Handshakenachrichten verwendet werden. Er wird einmal für jeden möglichen Hashingalgorithmus aufgerufen, der in der Clientauthentifizierungssignatur verwendet werden kann.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Header	Sslprovider.h
DLL	Ncrypt.dll

Freigeben über