Fonction ImageGetDigestStream (imagehlp.h)

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.

[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 :

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

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

Voir aussi

Fonctions ImageHlp