Fonction CryptDestroyHash (wincrypt.h)

Important Cette API est déconseillée. Les logiciels nouveaux et existants doivent commencer à utiliser les API de nouvelle génération de chiffrement. Microsoft peut supprimer cette API dans les versions ultérieures.

 

La fonction CryptDestroyHash détruit l’objet de hachage référencé par le paramètre hHash . Une fois qu’un objet de hachage a été détruit, il ne peut plus être utilisé.

Pour garantir la sécurité, nous vous recommandons de détruire les objets de hachage une fois qu’ils ont été utilisés.

Syntaxe

BOOL CryptDestroyHash(
  [in] HCRYPTHASH hHash
);

Paramètres

[in] hHash

Handle de l’objet de hachage à détruire.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Les codes d’erreur préfacés par « NTE » sont générés par le fournisseur de services de chiffrement (CSP) particulier que vous utilisez. Certains codes d’erreur possibles suivent.

Code de retour	Description
ERROR_BUSY	L’objet de hachage spécifié par hHash est actuellement utilisé et ne peut pas être détruit.
ERROR_INVALID_HANDLE	Le paramètre hHash spécifie un handle qui n’est pas valide.
ERROR_INVALID_PARAMETER	Le paramètre hHash contient une valeur qui n’est pas valide.
NTE_BAD_ALGID	Le handle hHash spécifie un algorithme que ce csp ne prend pas en charge.
NTE_BAD_HASH	L’objet de hachage spécifié par le paramètre hHash n’est pas valide.
NTE_BAD_UID	Le contexte CSP qui a été spécifié lors de la création de l’objet de hachage est introuvable.

Remarques

Lorsqu’un objet de hachage est détruit, de nombreux fournisseurs de services cloud remplacent la mémoire dans le csp où l’objet de hachage a été conservé. La mémoire csp est ensuite libérée.

Il doit y avoir une correspondance un-à-un entre les appels à CryptCreateHash et CryptDestroyHash.

Tous les objets de hachage qui ont été créés à l’aide d’un fournisseur de solutions Cloud spécifique doivent être détruits avant que ce handle CSP ne soit libéré avec la fonction CryptReleaseContext .

Exemples

Pour obtenir un exemple qui utilise la fonction CryptDestroyHash , consultez Exemple de programme C : création et hachage d’une clé de session.

Configuration requise

Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wincrypt.h
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll

Voir aussi

CryptCreateHash

CryptHashData

CryptSignHash

Fonctions de hachage et de signature numérique