Fungsi CreateUserProfileEx

[Fungsi ini tidak tersedia pada Windows Vista.]

Membuat profil pengguna untuk pengguna tertentu.

Sintaks

BOOL WINAPI CreateUserProfileEx(
  _In_      PSID    pSid,
  _In_      LPCTSTR lpUserName,
  _In_opt_  LPCTSTR lpUserHive,
  _Out_opt_ LPTSTR  lpProfileDir,
  _In_      DWORD   dwDirSize,
  _In_      BOOL    bWin9xUpg
);

Parameter

pSid [in]

Jenis: PSID

SID pengguna baru.

lpUserName [in]

Jenis: LPCTSTR

Penunjuk ke buffer yang berisi nama pengguna pengguna baru.

lpUserHive [in, opsional]

Jenis: LPCTSTR

Penunjuk ke buffer yang berisi sarang registri untuk digunakan. Parameter ini bisa NULL.

lpProfileDir [keluar, opsional]

Jenis: LPTSTR

Penunjuk ke buffer yang, ketika fungsi ini kembali, menerima jalur direktori profil pengguna. Parameter ini bisa NULL.

dwDirSize [in]

Jenis: DWORD

Ukuran buffer yang ditentukan oleh lpProfileDir, dalam TCHAR.

bWin9xUpg [in]

Jenis: BOOL

TRUE jika profil pengguna sedang dibuat sebagai bagian dari migrasi profil dari Windows 9x; jika tidak, FALSE.

Saat TRUE, profil pengguna disiapkan di direktori profil default—biasanya C:\Documents and Settings\UserName. Jika direktori tersebut sudah ada, direktori tersebut akan digunakan. Jika tidak, itu dibuat.

Jika FALSE, direktori profil default dibuat jika tidak ada. Jika direktori profil default sudah ada, direktori baru dibuat untuk profil pengguna ini.

Nilai kembali

Jenis: BOOL

Mengembalikan TRUE jika profil pengguna baru berhasil dibuat; jika tidak, FALSE.

Keterangan

Fungsi ini tidak dideklarasikan dalam header kit pengembangan perangkat lunak (SDK) dan tidak memiliki pustaka impor terkait. Anda harus menggunakan fungsi LoadLibrary dan GetProcAddress untuk menautkan ke Userenv.dll. Versi ANSI dari fungsi, CreateUserProfileExA direferensikan dari Userenv.dll sebagai ordinal 153. Versi Unicode, CreateUserProfileExW dirujuk sebagai ordinal 154.

Persyaratan