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 |