ImageDirectoryEntryToData, fonction (dbghelp.h)

Article
08/23/2023

Obtient l’accès aux données spécifiques à l’image.

Cette fonction a été remplacée par la fonction ImageDirectoryEntryToDataEx . Utilisez ImageDirectoryEntryToDataEx pour récupérer l’en-tête de section.

Syntaxe

PVOID IMAGEAPI ImageDirectoryEntryToData(
  [in]  PVOID   Base,
  [in]  BOOLEAN MappedAsImage,
  [in]  USHORT  DirectoryEntry,
  [out] PULONG  Size
);

Paramètres

[in] Base

Adresse de base de l’image.

[in] MappedAsImage

Si ce paramètre a la valeur TRUE, le fichier est mappé par le système en tant qu’image. Si l’indicateur a la valeur FALSE, le fichier est mappé en tant que fichier de données par la fonction MapViewOfFile .

[in] DirectoryEntry

Numéro d’index de l’entrée de répertoire souhaitée. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
IMAGE_DIRECTORY_ENTRY_ARCHITECTURE 7	Données spécifiques à l’architecture
IMAGE_DIRECTORY_ENTRY_BASERELOC 5	Table de déplacement de base
IMAGE_DIRECTORY_ENTRY_BOUND_IMPORT 11	Répertoire d’importation lié
IMAGE_DIRECTORY_ENTRY_COM_DESCRIPTOR 14	Table de descripteur COM
IMAGE_DIRECTORY_ENTRY_DEBUG 6	Répertoire de débogage
IMAGE_DIRECTORY_ENTRY_DELAY_IMPORT 13	Table d’importation différée
IMAGE_DIRECTORY_ENTRY_EXCEPTION 3	Répertoire d’exceptions
IMAGE_DIRECTORY_ENTRY_EXPORT 0	Exporter le répertoire
IMAGE_DIRECTORY_ENTRY_GLOBALPTR 8	Adresse virtuelle relative du pointeur global
IMAGE_DIRECTORY_ENTRY_IAT 12	Importer une table d’adresses
IMAGE_DIRECTORY_ENTRY_IMPORT 1	Importer le répertoire
IMAGE_DIRECTORY_ENTRY_LOAD_CONFIG 10	Charger le répertoire de configuration
IMAGE_DIRECTORY_ENTRY_RESOURCE 2	Répertoire de ressources
IMAGE_DIRECTORY_ENTRY_SECURITY 4	Répertoire de sécurité
IMAGE_DIRECTORY_ENTRY_TLS 9	Répertoire de stockage local du thread

[out] Size

Pointeur vers une variable qui reçoit la taille des données de l’entrée de répertoire, en octets.

Valeur retournée

Si la fonction réussit, la valeur de retour est un pointeur vers les données de l’entrée de répertoire.

Si la fonction échoue, la valeur de retour est NULL. Pour récupérer des informations d’erreur étendues, appelez GetLastError.

Remarques

La fonction ImageDirectoryEntryToData est utilisée pour obtenir l’accès aux données spécifiques à l’image.

Toutes les fonctions DbgHelp, 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
Plateforme cible	Windows
En-tête	dbghelp.h
Bibliothèque	Dbghelp.lib
DLL	Dbghelp.dll
Composant redistribuable	DbgHelp.dll 5.1 ou version ultérieure

Voir aussi

Fonctions DbgHelp

ImageDirectoryEntryToDataEx

MapViewOfFile

Partager via