Функция GetAllUsersProfileDirectoryA (userenv.h)
Извлекает путь к корню каталога, содержащего данные программы, к которым предоставлен доступ всем пользователям.
Синтаксис
USERENVAPI BOOL GetAllUsersProfileDirectoryA(
[out, optional] LPSTR lpProfileDir,
[in, out] LPDWORD lpcchSize
);
Параметры
[out, optional] lpProfileDir
Тип: LPTSTR
Указатель на буфер, который, когда эта функция возвращается успешно, получает путь. Задайте для этого значения значение null, чтобы определить требуемый размер буфера, включая завершающийся символ NULL.
[in, out] lpcchSize
Тип: LPDWORD
Указатель на размер буфера lpProfileDir в TCHARs.
Если буфер, указанный lpProfileDir, недостаточно велик или lpProfileDirnull, функция завершается ошибкой, и этот параметр получает необходимый размер буфера, включая завершающий символNULL.
Возвращаемое значение
Тип: BOOL
TRUE в случае успешного выполнения; в противном случае FALSE. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.
Замечания
Ниже приведен пример пути, возвращаемого GetAllUsersProfileDirectory в Windows XP:
C:\Documents and Settings\All Users
Ниже приведен пример пути, возвращаемого GetAllUsersProfileDirectory в Windows 7:
C:\ProgramData
Чтобы получить пути к подкаталогам этого каталога, используйте функцию SHGetFolderPath (Windows XP и более ранних версий) или SHGetKnownFolderPath (Windows Vista).
Заметка
Заголовок userenv.h определяет GetAllUsersProfileDirectory как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
Требование | Ценность |
---|---|
минимальные поддерживаемые клиентские | Windows 2000 Профессиональный [только классические приложения] |
минимальный поддерживаемый сервер | Windows 2000 Server [только классические приложения] |
целевая платформа | Виндоус |
заголовка | userenv.h |
библиотеки |
Userenv.lib |
DLL | Userenv.dll |
См. также
GetDefaultUserProfileDirectory
Обзор профилей пользователей
Справочник по профилям пользователей