Freigeben über

ImageDirectoryEntryToData-Funktion (dbghelp.h)

  • Artikel

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.

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

ImageDirectoryEntryToDataEx

MapViewOfFile