Funzione SslGetCipherSuitePRFHashAlgorithm

Articolo
06/12/2023

La funzione SslGetCipherSuitePRFHashAlgorithm restituisce l'API di crittografia: Identificatore di algoritmo CNG (Next Generation) dell'algoritmo hash usato per la funzione pseudo-casuale (TLS) del protocollo Transport Layer Security (PRF) per il protocollo di input, la suite di crittografia e il tipo di chiave.

Sintassi

SECURITY_STATUS WINAPI SslGetCipherSuitePRFHashAlgorithm(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _In_  DWORD              dwProtocol,
  _In_  DWORD              dwCipherSuite,
  _In_  DWORD              dwKeyType,
  _Out_ WCHAR              szPRFHash[NCRYPT_SSL_MAX_NAME_SIZE],
  _In_  DWORD              dwFlags
);

Parametri

hSslProvider [in]: Handle dell'istanza del provider del protocollo SSL (Secure Sockets Layer Protocol).
dwProtocol [in]: Uno dei valori CNG SSL Provider Protocol Identifier .
dwCipherSuite [in]: Uno dei valori CNG SSL Provider Cipher Suite Identifier .
dwKeyType [in]: Uno dei valori CNG SSL Provider Key Type Identifier . Per i tipi di chiave che non sono crittografia a curva ellittica (ECC), impostare questo parametro su zero.
szPRFHash [out]: Uno degli identificatori dell'algoritmo CNG per l'hash che verrà usato per il prf TLS.
dwFlags [in]: Questo parametro è riservato per 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, a titolo esemplificativo, quanto segue.

Codice/valore restituito	Descrizione
NTE_INVALID_HANDLE 0x80090026L	Il parametro hSslProvider contiene un puntatore non valido.
NTE_INVALID_PARAMETER 0x80090027L	Il parametro szPRFHash è impostato su NULL.
NTE_NOT_SUPPORTED 0x80090029L	La funzione selezionata non è supportata nella versione specificata dell'interfaccia.
NTE_BAD_FLAGS 0x80090009L	Il parametro dwFlags deve essere impostato su zero.

Commenti

Questa funzione SslGetCipherSuitePRFHashAlgorithm viene chiamata per le conversazioni TLS 1.2 o successive per eseguire una query sull'algoritmo hash che verrà usato nella prf TLS.

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

Condividi tramite