Funzione SslCreateHandshakeHash

Articolo
06/12/2023

La funzione SslCreateHandshakeHash ottiene un handle hash usato per eseguire l'hash dei messaggi di handshake.

Sintassi

SECURITY_STATUS WINAPI SslCreateHandshakeHash(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _Out_ NCRYPT_HASH_HANDLE *phHandshakeHash,
  _In_  DWORD              dwProtocol,
  _In_  DWORD              dwCipherSuite,
  _In_  DWORD              dwFlags
);

Parametri

hSslProvider [in]: Handle dell'istanza del provider del protocollo SSL (Secure Sockets Layer Protocol).
phHandshakeHash [out]: Handle hash che può essere passato ad altre funzioni del provider SSL.
dwProtocol [in]: Uno dei valori CNG SSL Provider Protocol Identifier .

Nota

Questa funzione non viene usata con il protocollo SSL 2.0.
dwCipherSuite [in]: Uno dei valori CNG SSL Provider Cipher Suite Identifier .
dwFlags [in]: Questo parametro è riservato per usi futuri.

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, a titolo esemplificativo, quanto segue.

Codice/valore restituito	Descrizione
NTE_NO_MEMORY 0x8009000EL	Memoria insufficiente per allocare il buffer hash.
NTE_INVALID_HANDLE 0x80090026L	L'handle hSslProvider non è valido.
NTE_INVALID_PARAMETER 0x80090027L	PhHandshakeHash è null.

Commenti

La funzione SslCreateHandshakeHash è una delle tre funzioni usate per generare un hash da usare durante l'handshake SSL.

La funzione SslCreateHandshakeHash viene chiamata per ottenere un handle hash.
La funzione SslHashHandshake viene chiamata un numero qualsiasi di volte con l'handle hash per aggiungere dati all'hash.
La funzione SslComputeFinishedHash viene chiamata con l'handle hash per ottenere il digest dei dati con hash.

Requisiti

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

Condividi tramite