Функция SymSetSearchPathW (dbghelp.h)

Статья
11/20/2024

Задает путь поиска для указанного процесса.

Синтаксис

BOOL IMAGEAPI SymSetSearchPathW(
  [in]           HANDLE hProcess,
  [in, optional] PCWSTR SearchPath
);

Параметры

[in] hProcess

Дескриптор процесса, который был первоначально передан в функцию SymInitialize.

[in, optional] SearchPath

Путь поиска символов. Строка может содержать несколько путей, разделенных точкой с запятой.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение TRUE.

Если функция завершается ошибкой, возвращаемое значение FALSE. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

Путь поиска символов можно изменить любое количество раз, пока библиотека используется приложением. Это изменение влияет на все будущие вызовы обработчика символов.

Чтобы получить текущий путь поиска, вызовите функцию SymGetSearchPath.

Все функции DbgHelp, такие как этот, являются одним потоком. Таким образом, вызовы из нескольких потоков в эту функцию, скорее всего, приведет к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все одновременные вызовы из нескольких потоков в эту функцию.

Чтобы вызвать версию этой функции Юникода, определите DBGHELP_TRANSLATE_TCHAR.

Заметка

Заголовок dbghelp.h определяет SymSetSearchPath как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	dbghelp.h
библиотеки	Dbghelp.lib
DLL	Dbghelp.dll
распространяемый	DbgHelp.dll 5.1 или более поздней версии

См. также

функций DbgHelp

SymGetSearchPath

SymInitialize

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