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
程式庫	Userenv.lib
Dll	Userenv.dll