createProfile 函数 (userenv.h)

创建新的用户配置文件。

语法

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

参数

[in] pszUserSid

类型： LPCWSTR

指向字符串形式的用户的 SID 的指针。

[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
标头	userenv.h
Library	Userenv.lib
DLL	Userenv.dll