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