Fungsi UnloadUserProfile (userenv.h)

Membongkar profil pengguna yang dimuat oleh fungsi LoadUserProfile . Penelepon harus memiliki hak administratif pada komputer. Untuk informasi selengkapnya, lihat bagian Keterangan dari fungsi LoadUserProfile .

Sintaks

USERENVAPI BOOL UnloadUserProfile(
  [in] HANDLE hToken,
  [in] HANDLE hProfile
);

Parameter

[in] hToken

Jenis: HANDEL

Token untuk pengguna, dikembalikan dari fungsi LogonUser, CreateRestrictedToken, DuplicateToken, OpenProcessToken, atau OpenThreadToken . Token harus memiliki akses TOKEN_IMPERSONATE dan TOKEN_DUPLICATE . Untuk informasi selengkapnya, lihat Hak Akses untuk Objek Access-Token.

[in] hProfile

Jenis: HANDEL

Tangani ke kunci registri. Nilai ini adalah anggota hProfile dari struktur PROFILEINFO . Untuk informasi selengkapnya, lihat bagian Keterangan dari LoadUserProfile dan Keamanan Kunci Registri dan Hak Akses.

Nilai kembali

Jenis: BOOL

TRUE jika berhasil; jika tidak, FALSE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Sebelum memanggil UnloadUserProfile , Anda harus memastikan bahwa semua handel ke kunci yang telah Anda buka di sarang registri pengguna ditutup. Jika Anda tidak menutup semua handel registri terbuka, profil pengguna gagal dibongkar. Untuk informasi selengkapnya, lihat Keamanan Kunci Registri dan Hak Akses dan Hives Registri.

Untuk informasi selengkapnya tentang fungsi panggilan yang memerlukan hak istimewa administrator, lihat Menjalankan dengan Hak Istimewa Khusus.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	userenv.h
Pustaka	Userenv.lib
DLL	Userenv.dll

Lihat juga

LoadUserProfile

PROFILEINFO

Gambaran Umum Profil Pengguna

Referensi Profil Pengguna