Fonction CryptHashSessionKey (wincrypt.h)

Article
08/27/2023

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 CryptHashSessionKey calcule le hachage de chiffrement d’un objet de clé de session . Cette fonction peut être appelée plusieurs fois avec le même handle de hachage pour calculer le hachage de plusieurs clés. Les appels à CryptHashSessionKey peuvent être entrecoupés d’appels à CryptHashData.

Avant d’appeler cette fonction, CryptCreateHash doit être appelé pour créer le handle d’un objet de hachage.

Syntaxe

BOOL CryptHashSessionKey(
  [in] HCRYPTHASH hHash,
  [in] HCRYPTKEY  hKey,
  [in] DWORD      dwFlags
);

Paramètres

[in] hHash

Handle de l’objet de hachage.

[in] hKey

Handle de l’objet clé à hacher.

[in] dwFlags

La valeur d’indicateur suivante est définie.

Valeur	Signification
CRYPT_LITTLE_ENDIAN 0x00000001	Lorsque cet indicateur est défini, les octets de la clé sont hachés au format little-endian . Notez que par défaut (lorsque dwFlags est égal à zéro), les octets de la clé sont hachés au format big-endian .

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE.

Si la fonction échoue, la valeur de retour est FALSE. 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 solutions Cloud que vous utilisez. Certains codes d’erreur possibles suivent.

Code de retour	Description
ERROR_INVALID_HANDLE	L’un des paramètres spécifie un handle qui n’est pas valide.
ERROR_INVALID_PARAMETER	L’un des paramètres contient une valeur qui n’est pas valide. Il s’agit le plus souvent d’un pointeur 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_FLAGS	Le paramètre dwFlags est différent de zéro.
NTE_BAD_HASH	L’objet de hachage spécifié par le paramètre hHash n’est pas valide.
NTE_BAD_HASH_STATE	Une tentative a été effectuée pour ajouter des données à un objet de hachage qui est déjà marqué « terminé ».
NTE_BAD_KEY	Un algorithme de hachage à clé est utilisé, mais la clé de session n’est plus valide. Cette erreur est générée si la clé de session est détruite avant la fin de l’opération de hachage.
NTE_BAD_UID	Le contexte CSP qui a été spécifié lors de la création de l’objet de hachage est introuvable.
NTE_FAIL	La fonction a échoué d’une manière inattendue.

Configuration requise

Condition requise	Valeur
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

CryptGenKey

CryptHashData

Fonctions de hachage et de signature numérique

Partager via