FindDebugInfoFileEx-Funktion (dbghelp.h)

Artikel
02/28/2024

Syntax

HANDLE IMAGEAPI FindDebugInfoFileEx(
  [in]           PCSTR                     FileName,
  [in]           PCSTR                     SymbolPath,
  [out]          PSTR                      DebugFilePath,
  [in, optional] PFIND_DEBUG_FILE_CALLBACK Callback,
  [in, optional] PVOID                     CallerData
);

Parameter

[in] FileName

Der Name der zu suchenden 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.

[in, optional] Callback

Eine anwendungsdefinierte Rückruffunktion, die überprüft, ob die richtige Datei gefunden wurde oder die Funktion ihre Suche fortsetzen soll. Weitere Informationen finden Sie unter FindDebugInfoFileProc.

Dieser Parameter kann NULL sein.

[in, optional] CallerData

Optionale benutzerdefinierte Daten, die an die Rückruffunktion übergeben werden sollen.

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 FindDebugInfoFileEx-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 werden, durchsucht die Funktion jedes angegebene Verzeichnis nach der Datei. Wenn sich die Datei befindet, wird die Suche beendet. Achten Sie daher darauf, SymbolPath mit den Pfaden in der richtigen Reihenfolge anzugeben.

Wenn der angegebene Dateiname keine DBG-Erweiterung enthält, sucht FindDebugInfoFileEx nach der Datei in der folgenden Reihenfolge:

SymbolPath\Symbols\ext\filename.dbg
SymbolPath\ext\filename.dbg
SymbolPath\Dateiname.dbg
FileNamePath\filename.dbg

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.

Um die Unicode-Version dieser Funktion aufzurufen, definieren Sie DBGHELP_TRANSLATE_TCHAR.