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


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

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

Синтаксис

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

Параметры

[out] lpProfileDir

Тип: LPTSTR

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

[in, out] lpcchSize

Тип: LPDWORD

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

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

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

Тип: BOOL

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

Комментарии

Ниже приведен пример пути, возвращаемого GetProfilesDirectory в Windows XP:

C:\Documents and Settings

Ниже приведен пример пути, возвращаемого GetProfilesDirectory в Windows 7:

C:\Users

Чтобы получить пути к подкаталогам этого каталога, используйте функцию SHGetFolderPath (Windows XP и более ранние версии) или SHGetKnownFolderPath (Windows Vista).

Примечание

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

Требования

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

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

GetAllUsersProfileDirectory

GetDefaultUserProfileDirectory

GetUserProfileDirectory

Обзор профилей пользователей

Справочник по профилям пользователей