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