Fungsi CreateProfile (userenv.h)

Artikel
03/15/2023

Membuat profil pengguna baru.

Sintaks

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

Parameter

[in] pszUserSid

Jenis: LPCWSTR

Arahkan ke SID pengguna sebagai string.

[in] pszUserName

Jenis: LPCWSTR

Nama pengguna dari pengguna baru. Nama ini digunakan sebagai nama dasar untuk direktori profil.

[out] pszProfilePath

Jenis: LPWSTR

Ketika fungsi ini kembali, berisi penunjuk ke jalur lengkap profil.

[in] cchProfilePath

Jenis: DWORD

Ukuran buffer yang ditujukkan oleh pszProfilePath, dalam karakter.

Menampilkan nilai

Jenis: HRESULT

Mengembalikan S_OK jika berhasil, atau nilai kesalahan jika tidak, termasuk yang berikut ini:

Menampilkan kode	Deskripsi
E_ACCESSDENIED	Pemanggil tidak memiliki tingkat izin yang memadai untuk membuat profil.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)	Profil sudah ada untuk pengguna yang ditentukan.

Keterangan

Pemanggil harus memiliki hak istimewa administrator untuk memanggil fungsi ini.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	userenv.h
Pustaka	Userenv.lib
DLL	Userenv.dll

Bagikan melalui