Функция GetProfilesDirectoryW (userenv.h)
Извлекает путь к корневому каталогу, в котором хранятся профили пользователей.
Синтаксис
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.
Комментарии
Ниже приведен пример пути, возвращаемого 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 |