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

Статья
11/20/2024

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

Синтаксис

PWSTR IMAGEAPI SymSetHomeDirectoryW(
  [in]           HANDLE hProcess,
  [in, optional] PCWSTR dir
);

Параметры

[in] hProcess

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

[in, optional] dir

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

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

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

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

Замечания

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

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

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

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

Заметка

Заголовок dbghelp.h определяет SymSetHomeDirectory как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	dbghelp.h
библиотеки	Dbghelp.lib
DLL	Dbghelp.dll
распространяемый	DbgHelp.dll 6.1 или более поздней версии

См. также

функций DbgHelp

SymGetHomeDirectory

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