ImageDirectoryEntryToData-Funktion (dbghelp.h)

Artikel
08/23/2023

Ruft Zugriff auf bildspezifische Daten ab.

Diese Funktion wurde durch die ImageDirectoryEntryToDataEx-Funktion abgelöst. Verwenden Sie ImageDirectoryEntryToDataEx , um den Abschnittsheader abzurufen.

Syntax

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

Parameter

[in] Base

Die Basisadresse des Bilds.

[in] MappedAsImage

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

[in] DirectoryEntry

Die Indexnummer des gewünschten Verzeichniseintrags. Dieser Parameter kann einen der folgenden Werte annehmen.

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 in Bytes empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Zeiger auf die Daten des Verzeichniseintrags.

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

Hinweise

Die ImageDirectoryEntryToData-Funktion wird verwendet, um Zugriff auf bildspezifische Daten zu erhalten.

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.