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

Создает новый профиль пользователя.

Синтаксис

USERENVAPI HRESULT CreateProfile(
  [in]  LPCWSTR pszUserSid,
  [in]  LPCWSTR pszUserName,
  [out] LPWSTR  pszProfilePath,
  [in]  DWORD   cchProfilePath
);

Параметры

[in] pszUserSid

Тип: LPCWSTR

Указатель на идентификатор безопасности пользователя в виде строки.

[in] pszUserName

Тип: LPCWSTR

Имя нового пользователя. Это имя используется в качестве базового имени для каталога профиля.

[out] pszProfilePath

Тип: LPWSTR

При возврате этой функции содержит указатель на полный путь к профилю.

[in] cchProfilePath

Тип: DWORD

Размер буфера, на который указывает pszProfilePath, в символах.

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

Тип: HRESULT

Возвращает S_OK в случае успешного выполнения или значение ошибки в противном случае, включая следующее:

Код возврата	Описание
E_ACCESSDENIED	Вызывающий объект не имеет достаточного уровня разрешений для создания профиля.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)	Профиль для указанного пользователя уже существует.

Комментарии

Вызывающий объект должен иметь права администратора для вызова этой функции.

Требования

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