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

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

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

Функции DbgHelp

SymInitialize

SymSetSearchPath