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

Статья
02/27/2024

Задает домашний каталог, используемый Dbghelp.

Синтаксис

PCHAR IMAGEAPI SymSetHomeDirectory(
  [in]           HANDLE hProcess,
  [in, optional] PCSTR  dir
);

Параметры

[in] hProcess

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

[in, optional] dir

Домашний каталог. Этот каталог должен быть доступен для записи, в противном случае домашний каталог — это общий каталог приложений, указанный в CSIDL_COMMON_APPDATA. Если этот параметр имеет значение NULL, функция использует каталог по умолчанию.

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

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

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

Домашний каталог по умолчанию — это каталог, в котором находится Dbghelp.dll. Dbghelp использует этот каталог в качестве основы для других каталогов, таких как подчиненный каталог хранилища по умолчанию (подкаталог sym домашнего каталога).

Домашний каталог, используемый для хранилища символов по умолчанию, и расположение кэша исходного сервера хранятся в переменной среды DBGHELP_HOMEDIR.

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

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

Требования

Требование	Значение
Целевая платформа	Windows
Header	dbghelp.h
Библиотека	Dbghelp.lib
DLL	Dbghelp.dll
Распространяемые компоненты	DbgHelp.dll 6.1 или более поздней версии

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

Функции DbgHelp

SymGetHomeDirectory

Share via