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