Функция 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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Целевая платформа | Windows |
| Header | dbghelp.h |
| Библиотека | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Распространяемые компоненты | DbgHelp.dll 5.1 или более поздней версии |