Fonction CryptHashSessionKey (wincrypt.h)

  • Article
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