Partager via


ImageDirectoryEntryToData, fonction (dbghelp.h)

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