FindDebugInfoFile-Funktion (dbghelp.h)

Sucht eine Debugdatei (DBG).

Verwenden Sie die FindDebugInfoFileEx-Funktion , um eine Rückruffunktion bereitzustellen, um die gefundene Symboldatei zu überprüfen.

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 partiellen Pfad verwenden.

[in] SymbolPath

Der Pfad, in dem sich Symboldateien befinden. Dies kann mehrere Pfade sein, die durch Semikolons getrennt werden. Verwenden Sie die SymGetSearchPath-Funktion , um den Symbolpfad abzurufen.

[out] DebugFilePath

Ein Zeiger auf einen Puffer, der den vollständigen Pfad der DBG-Datei empfängt. Dieser Puffer muss mindestens MAX_PATH+1 Zeichen sein.

Rückgabewert

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen abzurufen.

Bemerkungen

Die FindDebugInfoFile-Funktion wird verwendet, um eine DBG-Datei zu suchen. Diese Funktion wird bereitgestellt, sodass die Suche in mehreren verschiedenen Verzeichnissen über einen einzigen Funktionsaufruf durchgeführt werden kann. Der Parameter "SymbolPath" kann mehrere Pfade enthalten, wobei jeder durch ein Semikolon (;)) getrennt ist. Wenn mehrere Pfade angegeben werden, 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 single threaded. Daher führen Aufrufe von mehr als einem Thread zu dieser Funktion wahrscheinlich zu unerwartetem Verhalten oder Speicherbeschädigung. Um dies zu vermeiden, müssen Sie alle gleichzeitigen Aufrufe von mehr als einem Thread mit dieser Funktion synchronisieren.

Requirements

Siehe auch

DbgHelp-Funktionen

FindDebugInfoFileEx

SymGetSearchPath