SslGetCipherSuitePRFHashAlgorithm, fonction

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.

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