SslCreateHandshakeHash, fonction

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.

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