FindDebugInfoFile-Funktion (dbghelp.h)

Artikel
03/04/2024

Verwenden Sie die Funktion FindDebugInfoFileEx , um eine Rückruffunktion zum Überprüfen der angezeigten Symboldatei bereitzustellen.

Syntax

HANDLE IMAGEAPI FindDebugInfoFile(
  [in]  PCSTR FileName,
  [in]  PCSTR SymbolPath,
  [out] PSTR  DebugFilePath
);

Parameter

[in] FileName

Der Name der gewünschten DBG-Datei. Sie können einen Teilpfad verwenden.

[in] SymbolPath

Der Pfad, in dem sich Symboldateien befinden. Dies können mehrere Pfade sein, die durch Semikolons getrennt sind. Verwenden Sie zum Abrufen des Symbolpfads die SymGetSearchPath-Funktion .

[out] DebugFilePath

Ein Zeiger auf einen Puffer, der den vollständigen Pfad der DBG-Datei empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein geöffnetes Handle für die DBG-Datei.

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

Hinweise

Die FindDebugInfoFile-Funktion wird verwendet, um eine DBG-Datei zu suchen. Diese Funktion wird bereitgestellt, damit die Suche in mehreren verschiedenen Verzeichnissen über einen einzelnen Funktionsaufruf durchgeführt werden kann. Der SymbolPath-Parameter kann mehrere Pfade enthalten, wobei jeder durch ein Semikolon (;). Wenn mehrere Pfade angegeben sind, durchsucht die Funktion jedes Verzeichnis nach der Datei. Unterverzeichnisse werden nicht durchsucht. Wenn sich die Datei befindet, wird die Suche beendet. Achten Sie daher darauf, SymbolPath mit den Pfaden in der richtigen Reihenfolge anzugeben.

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.