MapDebugInformation-Funktion (dbghelp.h)

Artikel
08/23/2023

Ruft Zugriff auf die Debuginformationen für ein Image ab.

Hinweis Diese Funktion wird nur aus Gründen der Abwärtskompatibilität bereitgestellt. Es werden keine zuverlässigen Informationen zurückgegeben. Neue Anwendungen sollten die Funktionen SymGetModuleInfo64 und SymLoadModule64 verwenden.

Syntax

PIMAGE_DEBUG_INFORMATION IMAGEAPI MapDebugInformation(
  [in, optional] HANDLE FileHandle,
  [in]           PCSTR  FileName,
  [in, optional] PCSTR  SymbolPath,
  [in]           ULONG  ImageBase
);

Parameter

[in, optional] FileHandle

Ein Handle für ein geöffnetes ausführbares Image oder NULL.

[in] FileName

Der Name einer ausführbaren Imagedatei oder NULL.

[in, optional] SymbolPath

Der Pfad, in dem sich Symboldateien befinden. Der Pfad kann mehrere Pfade sein, die durch Semikolons getrennt sind. Um den Symbolpfad abzurufen, verwenden Sie die SymGetSearchPath-Funktion .

[in] ImageBase

Die Basisadresse für das Image oder null.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Zeiger auf eine IMAGE_DEBUG_INFORMATION-Struktur .

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

Hinweise

Die MapDebugInformation-Funktion wird verwendet, um Zugriff auf die Debuginformationen eines Images zu erhalten. Die Debuginformationen werden aus dem Bild oder der Symboldatei extrahiert und in die IMAGE_DEBUG_INFORMATION-Struktur eingefügt. Diese Struktur wird von der Bibliothek zugeordnet und muss mithilfe der Funktion UnmapDebugInformation zugeordnet werden. Der Arbeitsspeicher für die Struktur befindet sich nicht im Standardheap des Prozesses, sodass Versuche, ihn mit einer Speicherdeallocation-Routine freizugeben, fehlschlagen.

Alle DbgHelp-Funktionen, z. B. diese, sind single threaded. 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.