Fonction ImageGetDigestStream (imagehlp.h)

Article
02/27/2024

Récupère les données demandées à partir du fichier image spécifié.

Syntaxe

BOOL IMAGEAPI ImageGetDigestStream(
  [in] HANDLE          FileHandle,
  [in] DWORD           DigestLevel,
  [in] DIGEST_FUNCTION DigestFunction,
  [in] DIGEST_HANDLE   DigestHandle
);

Paramètres

[in] FileHandle

Handle du fichier image. Ce handle doit être ouvert pour FILE_READ_DATA accès.

[in] DigestLevel

Aspects de l’image à inclure dans le flux de données retourné. Ce paramètre peut prendre une ou plusieurs des valeurs suivantes.

Valeur	Signification
CERT_PE_IMAGE_DIGEST_ALL_IMPORT_INFO 0x04	Incluez toutes les informations d’importation.
CERT_PE_IMAGE_DIGEST_DEBUG_INFO 0x01	Incluez des informations de débogage symboliques.
CERT_PE_IMAGE_DIGEST_RESOURCES 0x02	Incluez des informations sur les ressources.

[in] DigestFunction

Pointeur vers une routine de rappel pour traiter les données. Pour plus d’informations, consultez DigestFunction.

[in] DigestHandle

Handle fourni par l’utilisateur pour la synthèse. Ce paramètre est passé à DigestFunction comme premier argument.

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 récupérer des informations d’erreur étendues, appelez GetLastError.

Remarques

La fonction ImageGetDigestStream retourne les données à digérer à partir d’un fichier image spécifié, sous réserve du paramètre DigestLevel passé. L’ordre des octets est cohérent pour différents appels, ce qui est nécessaire pour garantir que la même synthèse de message est toujours produite à partir du flux d’octets récupéré.

Pour garantir la compatibilité multiplateforme, toutes les implémentations de cette fonction doivent se comporter de manière cohérente en ce qui concerne l’ordre dans lequel les différentes parties du fichier image sont retournées.

Les données doivent être retournées dans l’ordre suivant :

Informations d’image (données exécutables et statiques).
Données de ressources.
Informations de débogage.

Si l’une d’elles n’est pas spécifiée, les parties restantes doivent être retournées dans le même ordre.

Toutes les fonctions ImageHlp, telles que celle-ci, sont à thread unique. Par conséquent, les appels de plusieurs threads à cette fonction entraîneront probablement un comportement inattendu ou une altération de la mémoire. Pour éviter cela, vous devez synchroniser tous les appels simultanés de plusieurs threads vers cette fonction.

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

Voir aussi

Fonctions ImageHlp

Partager via