Функция GetDefaultUserProfileDirectoryA (userenv.h)

Статья
08/26/2023

Извлекает путь к корню профиля пользователя по умолчанию.

Синтаксис

USERENVAPI BOOL GetDefaultUserProfileDirectoryA(
  [out, optional] LPSTR   lpProfileDir,
  [in, out]       LPDWORD lpcchSize
);

Параметры

[out, optional] lpProfileDir

Тип: LPTSTR

Указатель на буфер, который при успешном возврате этой функции получает путь к каталогу профиля пользователя по умолчанию. Присвойте этому значению значение NULL , чтобы определить требуемый размер буфера.

[in, out] lpcchSize

Тип: LPDWORD

Указывает размер буфера lpProfileDir в TCHAR.

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

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

Тип: BOOL

Значение TRUE в случае успешного выполнения; в противном случае — FALSE. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	userenv.h
Библиотека	Userenv.lib
DLL	Userenv.dll