SslGetCipherSuitePRFHashAlgorithm, fonction

Article
06/12/2023

La fonction SslGetCipherSuitePRFHashAlgorithm retourne l’identificateur d’algorithme CNG (Cryptography API: Next Generation) de l’algorithme de hachage utilisé pour la fonction pseudo-aléatoire du protocole TLS (Transport Layer Security Protocol) pour le protocole d’entrée, la suite de chiffrement et le type de clé.

Syntaxe

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

Paramètres

hSslProvider [in]: Handle du fournisseur de protocole SSL (Secure Sockets Layer Protocol) instance.
dwProtocol [in]: Une des valeurs de l’identificateur de protocole de fournisseur SSL CNG .
dwCipherSuite [in]: Une des valeurs de l’identificateur de suite de chiffrement du fournisseur SSL CNG .
dwKeyType [in]: Une des valeurs de l’identificateur de type de clé de fournisseur SSL CNG . Pour les types de clés qui ne sont pas un chiffrement de courbe elliptique (ECC), définissez ce paramètre sur zéro.
szPRFHash [out]: Un des identificateurs d’algorithme CNG pour le hachage qui sera utilisé pour le PRF TLS.
dwFlags [in]: Ce paramètre est réservé à une utilisation ultérieure et doit être défini sur zéro.

Valeur retournée

Si la fonction réussit, elle retourne zéro.

Si la fonction échoue, elle retourne une valeur d’erreur différente de zéro.

Les codes de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code/valeur de retour	Description
NTE_INVALID_HANDLE 0x80090026L	Le paramètre hSslProvider contient un pointeur qui n’est pas valide.
NTE_INVALID_PARAMETER 0x80090027L	Le paramètre szPRFHash a la valeur NULL.
NTE_NOT_SUPPORTED 0x80090029L	La fonction sélectionnée n’est pas prise en charge dans la version spécifiée de l’interface.
NTE_BAD_FLAGS 0x80090009L	Le paramètre dwFlags doit être défini sur zéro.

Notes

Cette fonction SslGetCipherSuitePRFHashAlgorithm est appelée pour les conversations TLS 1.2 ou ultérieures afin d’interroger l’algorithme de hachage qui sera utilisé dans le PRF TLS.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
En-tête	Sslprovider.h
DLL	Ncrypt.dll