ImageDirectoryEntryToDataEx-Funktion (dbghelp.h)

Artikel
08/23/2023

Sucht einen Verzeichniseintrag im Imageheader und gibt die Adresse der Daten für den Verzeichniseintrag zurück. Diese Funktion gibt den Abschnittsheader für die gespeicherten Daten zurück, sofern vorhanden.

Syntax

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

Parameter

[in] Base

Die Basisadresse des Bilds oder der Datendatei.

[in] MappedAsImage

Wenn das Flag TRUE ist, wird die Datei vom System als Bild zugeordnet. Wenn dieses Flag FALSE ist, wird die Datei von der MapViewOfFile-Funktion als Datendatei zugeordnet.

[in] DirectoryEntry

Der verzeichniseintrag, der gefunden werden soll. Der Wert muss einer der folgenden Werte sein.

Wert	Bedeutung
IMAGE_DIRECTORY_ENTRY_ARCHITECTURE 7	Architekturspezifische Daten
IMAGE_DIRECTORY_ENTRY_BASERELOC 5	Basis-Umlagerungstabelle
IMAGE_DIRECTORY_ENTRY_BOUND_IMPORT 11	Gebundenes Importverzeichnis
IMAGE_DIRECTORY_ENTRY_COM_DESCRIPTOR 14	COM-Deskriptortabelle
IMAGE_DIRECTORY_ENTRY_DEBUG 6	Debugverzeichnis
IMAGE_DIRECTORY_ENTRY_DELAY_IMPORT 13	Verzögerte Importtabelle
IMAGE_DIRECTORY_ENTRY_EXCEPTION 3	Ausnahmeverzeichnis
IMAGE_DIRECTORY_ENTRY_EXPORT 0	Verzeichnis exportieren
IMAGE_DIRECTORY_ENTRY_GLOBALPTR 8	Die relative virtuelle Adresse des globalen Zeigers
IMAGE_DIRECTORY_ENTRY_IAT 12	Importieren der Adresstabelle
IMAGE_DIRECTORY_ENTRY_IMPORT 1	Verzeichnis importieren
IMAGE_DIRECTORY_ENTRY_LOAD_CONFIG 10	Laden des Konfigurationsverzeichnisses
IMAGE_DIRECTORY_ENTRY_RESOURCE 2	Ressourcenverzeichnis
IMAGE_DIRECTORY_ENTRY_SECURITY 4	Sicherheitsverzeichnis
IMAGE_DIRECTORY_ENTRY_TLS 9	Lokales Threadspeicherverzeichnis

[out] Size

Ein Zeiger auf eine Variable, die die Größe der Daten für den verzeichniseintrag empfängt, der sich befindet.

[out, optional] FoundHeader

Ein Zeiger auf eine IMAGE_SECTION_HEADER Struktur, die die Daten empfängt. Wenn der Abschnittsheader nicht vorhanden ist, ist dieser Parameter NULL.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Zeiger auf die Daten für den Verzeichniseintrag.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Alle DbgHelp-Funktionen, z. B. diese, sind singlethreaded. Daher führen an diese Funktion gerichtete Aufrufe mehrerer Threads wahrscheinlich zu unerwartetem Verhalten oder einer Beschädigung des Speichers. Um dies zu vermeiden, müssen Sie alle an diese Funktion gerichteten gleichzeitigen Aufrufe mehrerer Threads synchronisieren.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	dbghelp.h
Bibliothek	Dbghelp.lib
DLL	Dbghelp.dll
Verteilbare Komponente	DbgHelp.dll 5.1 oder höher

Weitere Informationen

DbgHelp-Funktionen

IMAGE_SECTION_HEADER

MapViewOfFile

Freigeben über