SslCreateHandshakeHash, fonction

  • Article

La fonction SslCreateHandshakeHash obtient un handle de hachage utilisé pour hacher les messages de négociation.

Syntaxe

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

Paramètres

hSslProvider [in]

Handle du fournisseur de protocole SSL (Secure Sockets Layer Protocol) instance.

phHandshakeHash [out]

Un handle de hachage qui peut être transmis à d’autres fonctions de fournisseur SSL.

dwProtocol [in]

Une des valeurs de l’identificateur de protocole du fournisseur SSL CNG .

Notes

Cette fonction n’est pas utilisée avec le protocole SSL 2.0.

dwCipherSuite [in]

Une des valeurs de l’identificateur de suite de chiffrement du fournisseur SSL CNG .

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 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_NO_MEMORY
0x8009000EL
 La mémoire est insuffisante pour allouer la mémoire tampon de hachage.
NTE_INVALID_HANDLE
0x80090026L
 Le handle hSslProvider n’est pas valide.
NTE_INVALID_PARAMETER
0x80090027L
 PhHandshakeHash est null.

Notes

La fonction SslCreateHandshakeHash est l’une des trois fonctions utilisées pour générer un hachage à utiliser pendant la négociation SSL.

  1. La fonction SslCreateHandshakeHash est appelée pour obtenir un handle de hachage.
  2. La fonction SslHashHandshake est appelée n’importe quel nombre de fois avec le handle de hachage pour ajouter des données au hachage.
  3. La fonction SslComputeFinishedHash est appelée avec le handle de hachage pour obtenir le résumé des données hachées.

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