SslCreateClientAuthHash, fonction

Article
06/13/2023

La fonction SslCreateClientAuthHash récupère un handle du hachage de négociation utilisé pour l’authentification du client.

Syntaxe

SECURITY_STATUS WINAPI SslCreateClientAuthHash(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _Out_ NCRYPT_HASH_HANDLE *phHandshakeHash,
  _In_  DWORD              dwProtocol,
  _In_  DWORD              dwCipherSuite,
  _In_  LPCWSTR            pszHashAlgId,
  _In_  DWORD              dwFlags
);

Paramètres

hSslProvider [in]: Handle du fournisseur de protocole SSL (Secure Sockets Layer Protocol) instance.
phHandshakeHash [out]: Pointeur vers une variable NCRYPT_HASH_HANDLE pour recevoir le handle de hachage.
dwProtocol [in]: Une des valeurs de l’identificateur de protocole du fournisseur SSL CNG .
dwCipherSuite [in]: Une des valeurs de l’identificateur de suite de chiffrement du fournisseur SSL CNG .
pszHashAlgId [in]: Une des valeurs des identificateurs d’algorithme CNG .
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 phHandshakeHash 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_NO_MEMORY 0x8009000EL	Mémoire insuffisante pour allouer des mémoires tampons.
NTE_BAD_FLAGS 0x80090009L	Le paramètre dwFlags doit être défini sur zéro.

Notes

La fonction SslCreateClientAuthHash est appelée pour les conversations TLS ( Transport Layer Security Protocol ) 1.2 ou ultérieures pour créer des objets de hachage utilisés pour hacher des messages de négociation. Il est appelé une fois pour chaque algorithme de hachage possible qui peut être utilisé dans la signature d’authentification du client.

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

Partager via