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

新使用者的 SID。

lpUserName [in]

類型： LPCTSTR

緩衝區的指標，其中包含新使用者的使用者名稱。

lpUserHive [in， optional]

類型： LPCTSTR

緩衝區的指標，其中包含要使用的 登錄區 。 此參數可以是 Null。

lpProfileDir [out， optional]

類型： LPTSTR

緩衝區的指標，當此函式傳回時，會收到使用者的設定檔目錄路徑。 此參數可以是 Null。

dwDirSize [in]

類型： DWORD

TCHAR 中 lpProfileDir所指定的緩衝區大小。

bWin9xUpg [in]

類型： BOOL

如果在從 Windows 9x 進行設定檔移轉時建立使用者設定檔，則為TRUE;否則為FALSE。

當 為 TRUE時，使用者設定檔會在預設設定檔目錄中設定，通常是 C：\Documents and Settings\UserName。 如果該目錄已經存在，則會使用它。 如果沒有，則會建立它。

如果 為 FALSE，則會在不存在時建立預設設定檔目錄。 如果預設設定檔目錄已經存在，則會為此使用者設定檔建立新的目錄。

傳回值

類型： BOOL

如果成功建立新的使用者設定檔，則傳回 TRUE ;否則為 FALSE。

備註

此函式不會在軟體發展工具組中宣告 (SDK) 標頭，而且沒有相關聯的匯入程式庫。 您必須使用 LoadLibrary 和 GetProcAddress 函式連結至 Userenv.dll。 CreateUserProfileExA函式的 ANSI 版本會從 Userenv.dll 參考為序數 153。 Unicode 版本 CreateUserProfileExW 會參考為序數 154。

規格需求

需求	值
用戶端支援結束	Windows XP
DLL	Userenv.dll
Unicode 與 ANSI 名稱	CreateUserProfileExW (Unicode) 和 CreateUserProfileExA (ANSI)