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

Статья
02/26/2024

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

Синтаксис

PCHAR IMAGEAPI SymGetHomeDirectory(
  [in]  DWORD  type,
  [out] PSTR   dir,
  [in]  size_t size
);

Параметры

[in] type

Извлекаемая папка. Этот параметр может принимать одно из указанных ниже значений.

Значение	Значение
hdBase 0	Домашний каталог.
hdSrc 2	Исходный каталог.
hdSym 1	Каталог символов.

[out] dir

Указатель на строку, получающую каталог.

[in] size

Размер выходного буфера в символах.

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

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

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

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

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

Требования

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

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

Функции DbgHelp

SymSetHomeDirectory

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