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

Статья
08/26/2023

Извлекает путь к корневому каталогу, в котором хранятся профили пользователей.

Синтаксис

USERENVAPI BOOL GetProfilesDirectoryW(
  [out]     LPWSTR  lpProfileDir,
  [in, out] LPDWORD lpcchSize
);

Параметры

[out] lpProfileDir

Тип: LPTSTR

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

[in, out] lpcchSize

Тип: LPDWORD

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

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

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

Тип: BOOL

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

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

Требования

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