SslLookupCipherLengths, fonction

Article
01/28/2024

La fonction SslLookupCipherLengths retourne une structure NCRYPT_SSL_CIPHER_LENGTHS qui contient les longueurs d’en-tête et de bande-annonce du protocole d’entrée, de la suite de chiffrement et du type de clé.

Syntaxe

SECURITY_STATUS WINAPI SslLookupCipherLengths(
  _In_  NCRYPT_PROV_HANDLE        hSslProvider,
  _In_  DWORD                     dwProtocol,
  _In_  DWORD                     dwCipherSuite,
  _In_  DWORD                     dwKeyType,
  _Out_ NCRYPT_SSL_CIPHER_LENGTHS *pCipherLengths,
  _In_  DWORD                     cbCipherLengths,
  _In_  DWORD                     dwFlags
);

Paramètres

hSslProvider [in]: Handle de 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 d’identificateur de suite de chiffrement du fournisseur SSL CNG .
dwKeyType [in]: L’une des valeurs d’identificateur de type de clé du fournisseur SSL CNG . Pour les types de clés qui ne sont pas le chiffrement de courbe elliptique (ECC), définissez ce paramètre sur zéro.
pCipherLengths [out]: Pointeur vers une mémoire tampon pour recevoir la structure NCRYPT_SSL_CIPHER_LENGTHS .
cbCipherLengths [in]: Longueur, en octets, de la mémoire tampon pointée par le paramètre pCipherLengths .
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 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 paramètre hSslProvider contient un pointeur qui n’est pas valide.
NTE_INVALID_PARAMETER 0x80090027L	Le paramètre pCipherLengths est défini sur NULL ou la longueur de mémoire tampon spécifiée par les valeurs cbCipherLengths est trop courte.
NTE_BAD_FLAGS 0x80090009L	Le paramètre dwFlags doit être défini sur zéro.

Notes

La fonction SslLookupCipherLengths est appelée pour les conversations TLS ( Transport Layer Security Protocol) 1.1 ou ultérieures pour interroger les longueurs d’en-tête et de bande-annonce pour le protocole demandé, la suite de chiffrement et le type de clé.

Configuration requise

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