Функция SymSetSearchPath (dbghelp.h)
Задает путь поиска для указанного процесса.
Синтаксис
BOOL IMAGEAPI SymSetSearchPath(
[in] HANDLE hProcess,
[in, optional] PCSTR SearchPath
);
Параметры
[in] hProcess
Дескриптор процесса, который изначально был передан в функцию SymInitialize .
[in, optional] SearchPath
Путь поиска символов. Строка может содержать несколько путей, разделенных точкой с запятой.
Возвращаемое значение
Если функция выполняется успешно, возвращается значение TRUE.
Если функция завершается сбоем, возвращается значение FALSE. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError.
Комментарии
Путь поиска символов можно изменять любое количество раз, пока библиотека используется приложением. Изменение влияет на все будущие вызовы обработчика символов.
Чтобы получить текущий путь поиска, вызовите функцию SymGetSearchPath .
Все функции DbgHelp, такие как эта, являются однопоточными. Поэтому вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.
Чтобы вызвать версию этой функции в Юникоде, определите DBGHELP_TRANSLATE_TCHAR.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | dbghelp.h |
| Библиотека | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Распространяемые компоненты | DbgHelp.dll 5.1 или более поздней версии |