SymSetSearchPath-Funktion (dbghelp.h)
Legt den Suchpfad für den angegebenen Prozess fest.
BOOL IMAGEAPI SymSetSearchPath(
[in] HANDLE hProcess,
[in, optional] PCSTR SearchPath
);
[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.
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.
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.
Anforderung | Wert |
---|---|
Zielplattform | Windows |
Kopfzeile | dbghelp.h |
Bibliothek | Dbghelp.lib |
DLL | Dbghelp.dll |
Verteilbare Komponente | DbgHelp.dll 5.1 oder höher |