Поделиться через


Функция 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 или более поздней версии

См. также раздел

Функции DbgHelp

SymGetSearchPath

SymInitialize