Funzione SslCreateClientAuthHash

Articolo
06/13/2023

La funzione SslCreateClientAuthHash recupera un handle per l'hash handshake usato per l'autenticazione client.

Sintassi

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
);

Parametri

hSslProvider [in]: Handle dell'istanza del provider di protocollo SSL (Secure Sockets Layer Protocol).
phHandshakeHash [out]: Puntatore a una variabile NCRYPT_HASH_HANDLE per ricevere l'handle hash.
dwProtocol [in]: Uno dei valori identificatore del protocollo ssl del provider CNG .
dwCipherSuite [in]: Uno dei valori identificatore del provider SSL CNG .
pszHashAlgId [in]: Uno dei valori degli identificatori dell'algoritmo CNG .
dwFlags [in]: Questo parametro è riservato per l'uso futuro e deve essere impostato su zero.

Valore restituito

Se la funzione ha esito positivo, restituisce zero.

Se la funzione ha esito negativo, restituisce un valore di errore diverso da zero.

I codici restituiti possibili includono, ma non sono limitati a, i seguenti.

Codice/valore restituito	Descrizione
NTE_INVALID_HANDLE 0x80090026L	Il parametro hSslProvider contiene un puntatore non valido.
NTE_INVALID_PARAMETER 0x80090027L	Il parametro phHandshakeHash è impostato su NULL.
NTE_NOT_SUPPORTED 0x80090029L	La funzione selezionata non è supportata nella versione specificata dell'interfaccia.
NTE_NO_MEMORY 0x8009000EL	Memoria insufficiente per allocare buffer.
NTE_BAD_FLAGS 0x8009009L	Il parametro dwFlags deve essere impostato su zero.

Commenti

La funzione SslCreateClientAuthHash viene chiamata per il protocollo TLS (Transport Layer Security Protocol ) 1.2 o versioni successive per creare oggetti hash usati per hashshake messaggi. Viene chiamato una volta per ogni possibile algoritmo di hashing che può essere usato nella firma di autenticazione client.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Intestazione	Sslprovider.h
DLL	Ncrypt.dll

Share via