SslLookupCipherSuiteInfo, fonction

La fonction SslLookupCipherSuiteInfo récupère les informations de la suite de chiffrement pour un protocole, une suite de chiffrement et un jeu de types de clés spécifiés.

Syntaxe

SECURITY_STATUS WINAPI SslLookupCipherSuiteInfo(
  _In_  NCRYPT_PROV_HANDLE      hSslProvider,
  _In_  DWORD                   dwProtocol,
  _In_  DWORD                   dwCipherSuite,
  _In_  DWORD                   dwKeyType,
  _Out_ NCRYPT_SSL_CIPHER_SUITE *pCipherSuite,
  _In_  DWORD                   dwFlags
);

Paramètres

hSslProvider [in]

Handle vers l’instance du fournisseur de protocole SSL ( Secure Sockets Layer ).

dwProtocol [in]

L’une des valeurs d’identificateur de protocole du fournisseur SSL CNG .

dwCipherSuite [in]

L’une des valeurs des identificateurs de suite de chiffrement du fournisseur SSL CNG .

dwKeyType [in]

L’une des valeurs D’identificateurs de type de clé du fournisseur SSL CNG .

pCipherSuite [out]

Adresse d’une mémoire tampon qui contient une structure NCRYPT_SSL_CIPHER_SUITE dans laquelle écrire les informations de la suite de chiffrement.

dwFlags [in]

Ce paramètre est réservé à un usage futur.

Valeur retournée

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

Si la fonction échoue, elle retourne une valeur d’erreur non nulle.

Les codes de retour possibles incluent, mais ne sont pas limités à, les éléments suivants.

Code/valeur de retour	Description
NTE_INVALID_HANDLE 0x80090026L	Le handle hSslProvider n’est pas valide.

Spécifications

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