SymSetSearchPath-Funktion (dbghelp.h)

Artikel
02/29/2024

Legt den Suchpfad für den angegebenen Prozess fest.

Syntax

BOOL IMAGEAPI SymSetSearchPath(
  [in]           HANDLE hProcess,
  [in, optional] PCSTR  SearchPath
);

Parameter

[in] hProcess

Ein Handle für den Prozess, der ursprünglich an die SymInitialize-Funktion übergeben wurde.

[in, optional] SearchPath

Der Suchpfad des Symbols. Die Zeichenfolge kann mehrere Pfade enthalten, die durch Semikolons getrennt sind.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Hinweise

Der Symbolsuchpfad kann beliebig oft geändert werden, während die Bibliothek von einer Anwendung verwendet wird. Die Änderung wirkt sich auf alle zukünftigen Aufrufe des Symbolhandlers aus.

Rufen Sie die SymGetSearchPath-Funktion auf, um den aktuellen Suchpfad abzurufen.

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.