ImageDirectoryEntryToDataEx, fonction (dbghelp.h)

Article
02/26/2024

Recherche une entrée de répertoire dans l’en-tête d’image et retourne l’adresse des données de l’entrée de répertoire. Cette fonction retourne l’en-tête de section pour les données situées, le cas échéant.

Syntaxe

PVOID IMAGEAPI ImageDirectoryEntryToDataEx(
  [in]            PVOID                 Base,
  [in]            BOOLEAN               MappedAsImage,
  [in]            USHORT                DirectoryEntry,
  [out]           PULONG                Size,
  [out, optional] PIMAGE_SECTION_HEADER *FoundHeader
);

Paramètres

[in] Base

Adresse de base de l’image ou du fichier de données.

[in] MappedAsImage

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

[in] DirectoryEntry

Entrée de répertoire à trouver. La valeur doit être l’une des 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 qui se trouve.

[out, optional] FoundHeader

Pointeur vers une structure IMAGE_SECTION_HEADER qui reçoit les données. Si l’en-tête de section n’existe pas, ce paramètre est NULL.

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.

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

IMAGE_SECTION_HEADER

MapViewOfFile

Partager via