通过

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
);

parameters

pSid [in]

类型： PSID

新用户的 SID。

lpUserName [in]

类型： LPCTSTR

指向包含新用户的用户名的缓冲区的指针。

lpUserHive [in， optional]

类型： LPCTSTR

指向包含要使用的 注册表配置单元 的缓冲区的指针。 此参数可以为 NULL。

lpProfileDir [out， optional]

类型： LPTSTR

指向缓冲区的指针，当此函数返回时，该缓冲区接收用户的配置文件目录路径。 此参数可以为 NULL。

dwDirSize [in]

类型：DWORD

lpProfileDir 指定的缓冲区的大小（以 TCHAR 为单位）。

bWin9xUpg [in]

类型： BOOL

如果在从 Windows 9x 迁移配置文件时创建用户配置文件，则为 TRUE;否则为 FALSE。

如果 为 TRUE，则会在默认配置文件目录中设置用户配置文件，通常为 C：\Documents 和 Settings\UserName。 如果该目录已存在，则使用该目录。 如果未创建，则创建它。

如果 为 FALSE，则创建默认配置文件目录（如果不存在）。 如果默认配置文件目录已存在，则会为此用户配置文件创建新目录。

返回值

类型： BOOL

如果成功创建新的用户配置文件，则返回 TRUE ;否则为 FALSE。

备注

此函数未在软件开发工具包 (SDK) 标头中声明，并且没有关联的导入库。 必须使用 LoadLibrary 和 GetProcAddress 函数链接到Userenv.dll。 函数的 ANSI 版本 CreateUserProfileExA 从 Userenv.dll 引用为序号 153。 Unicode 版本 CreateUserProfileExW 被引用为序号 154。

要求

要求 值
客户端支持终止
 Windows XP
DLL
Userenv.dll
Unicode 和 ANSI 名称
 CreateUserProfileExW (Unicode) 和 CreateUserProfileExA (ANSI)