Partager via


CryptCATAdminCalcHashFromFileHandle, fonction (mscat.h)

[La fonction CryptCATAdminCalcHashFromFileHandle peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

La fonction CryptCATAdminCalcHashFromFileHandle calcule le hachage d’un fichier. Cette fonction n’a pas de bibliothèque d’importation associée. Vous devez utiliser les fonctions LoadLibrary et GetProcAddress pour établir une liaison dynamique vers Wintrust.dll.

Syntaxe

BOOL CryptCATAdminCalcHashFromFileHandle(
  [in]      HANDLE hFile,
  [in, out] DWORD  *pcbHash,
  [in]      BYTE   *pbHash,
  [in]      DWORD  dwFlags
);

Paramètres

[in] hFile

Handle du fichier dont le hachage est en cours de calcul. Ce paramètre ne peut pas être NULL et doit être un handle de fichier valide.

[in, out] pcbHash

Pointeur vers une variable DWORD qui contient le nombre d’octets dans pbHash. Lors de l’entrée, définissez pcbHash sur le nombre d’octets alloués pour pbHash. Lors du retour, pcbHash contient le nombre d’octets retournés dans pbHash. Si pbHash est passé en tant que NULL, pcbHash contient le nombre d’octets à allouer pour pbHash.

[in] pbHash

Pointeur vers une mémoire tampon BYTE qui reçoit le hachage. Si ce paramètre est passé en tant que NULL, pcbHash contient le nombre d’octets à allouer pour pbHash, et un appel ultérieur peut être effectué pour récupérer le hachage.

[in] dwFlags

Ce paramètre est réservé à une utilisation ultérieure et doit être défini sur zéro.

Valeur retournée

La valeur de retour est TRUE si la fonction réussit ; FALSE si la fonction échoue. Si false est retourné, appelez la fonction GetLastError pour déterminer la raison de l’échec. Si la mémoire allouée à pbHash est insuffisante, la fonction CryptCATAdminCalcHashFromFileHandle définit la dernière erreur sur ERROR_INSUFFICIENT_BUFFER.

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 mscat.h
Bibliothèque Wintrust.lib
DLL Wintrust.dll