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

Функция CreateUserProfileEx

  • Статья

[Эта функция недоступна в Windows Vista.]

Создает профиль пользователя для указанного пользователя.

Синтаксис

BOOL WINAPI CreateUserProfileEx(
  _In_      PSID    pSid,
  _In_      LPCTSTR lpUserName,
  _In_opt_  LPCTSTR lpUserHive,
  _Out_opt_ LPTSTR  lpProfileDir,
  _In_      DWORD   dwDirSize,
  _In_      BOOL    bWin9xUpg
);

Параметры

pSid [in]

Тип: PSID

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

lpUserName [in]

Тип: LPCTSTR

Указатель на буфер, содержащий имя нового пользователя.

lpUserHive [in, необязательный]

Тип: LPCTSTR

Указатель на буфер, содержащий используемый куст реестра . Этот параметр может принимать значение NULL.

lpProfileDir [out, optional]

Тип: LPTSTR

Указатель на буфер, который при возврате этой функции получает путь к каталогу профиля пользователя. Этот параметр может принимать значение NULL.

dwDirSize [in]

Тип: DWORD

Размер буфера, заданного lpProfileDir, в TCHAR.

bWin9xUpg [in]

Тип: BOOL

ЗНАЧЕНИЕ TRUE , если профиль пользователя создается в рамках миграции профиля из Windows 9x; в противном случае — FALSE.

При значении TRUE профиль пользователя настраивается в каталоге профилей по умолчанию— обычно это C:\Documents и Settings\UserName. Если этот каталог уже существует, он используется. Если это не так, он создается.

Если задано значение FALSE, создается каталог профиля по умолчанию, если он не существует. Если каталог профиля по умолчанию уже существует, для этого профиля пользователя создается новый каталог.

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

Тип: BOOL

Возвращает значение TRUE , если новый профиль пользователя был успешно создан; в противном случае — FALSE.

Комментарии

Эта функция не объявлена в заголовках пакета sdk и не имеет связанной библиотеки импорта. Для связи с Userenv.dll необходимо использовать функции LoadLibrary и GetProcAddress . Версия ANSI функции CreateUserProfileExA ссылается из Userenv.dll как порядковый номер 153. Версия Юникода CreateUserProfileExW называется порядковый номер 154.

Требования

Требование Значение
Окончание поддержки клиентов
 Windows XP
DLL
Userenv.dll
Имя в кодировке Юникод и ANSI
 CreateUserProfileExW (Юникод) и CreateUserProfileExA (ANSI)