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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[out] lpProfileDir

Тип: LPTSTR

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

[in, out] lpcchSize

Тип: LPDWORD

Задает размер буфера lpProfilesDir в TCHARs.

Если буфер, указанный lpProfilesDir недостаточно велик или lpProfilesDirNULL, функция завершается ошибкой, и этот параметр получает необходимый размер буфера, включая конечный символ 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 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	userenv.h
библиотеки	Userenv.lib
DLL	Userenv.dll

См. также

GetAllUsersProfileDirectory

GetDefaultUserProfileDirectory

GetUserProfileDirectory

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

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

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