Fungsi RegOpenUserClassesRoot (winreg.h)
Mengambil handel ke kunci HKEY_CLASSES_ROOT untuk pengguna tertentu. Pengguna diidentifikasi oleh token akses. Kunci yang dikembalikan memiliki tampilan registri yang menggabungkan konten kunci HKEY_LOCAL_MACHINE\Software\Classes dengan konten kunci Software\Classes di sarang registri pengguna. Untuk informasi selengkapnya, lihat Kunci HKEY_CLASSES_ROOT.
Sintaks
LSTATUS RegOpenUserClassesRoot(
[in] HANDLE hToken,
DWORD dwOptions,
[in] REGSAM samDesired,
[out] PHKEY phkResult
);
Parameter
[in] hToken
Handel ke token akses utama atau peniruan identitas yang mengidentifikasi pengguna yang menarik. Ini bisa menjadi handel token yang dikembalikan oleh panggilan ke fungsi LogonUser, CreateRestrictedToken, DuplicateToken, DuplicateTokenEx, OpenProcessToken, atau OpenThreadToken .
Handel harus memiliki akses TOKEN_QUERY. Untuk informasi selengkapnya, lihat Hak Akses untuk Objek Access-Token.
dwOptions
Parameter ini dicadangkan dan harus nol.
[in] samDesired
Masker yang menentukan hak akses yang diinginkan ke kunci. Fungsi gagal jika pendeskripsi keamanan kunci tidak mengizinkan akses yang diminta untuk proses panggilan. Untuk informasi selengkapnya, lihat Keamanan Kunci Registri dan Hak Akses.
[out] phkResult
Penunjuk ke variabel yang menerima handel ke kunci yang dibuka. Ketika Anda tidak lagi memerlukan handel yang dikembalikan, panggil fungsi RegCloseKey untuk menutupnya.
Mengembalikan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.
Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan bukan nol yang ditentukan dalam Winerror.h. Anda dapat menggunakan fungsi FormatMessage dengan bendera FORMAT_MESSAGE_FROM_SYSTEM untuk mendapatkan deskripsi umum tentang kesalahan tersebut.
Keterangan
Fungsi RegOpenUserClassesRoot memungkinkan Anda mengambil informasi HKEY_CLASSES_ROOT gabungan untuk pengguna selain pengguna interaktif. Misalnya, komponen server aplikasi klien/server dapat menggunakan RegOpenUserClassesRoot untuk mengambil informasi gabungan untuk klien.
RegOpenUserClassesRoot gagal jika profil pengguna untuk pengguna yang ditentukan tidak dimuat. Saat pengguna masuk secara interaktif, sistem secara otomatis memuat profil pengguna. Untuk pengguna lain, Anda dapat memanggil fungsi LoadUserProfile untuk memuat profil pengguna. Namun, LoadUserProfile bisa sangat memakan waktu, jadi jangan menyebutnya untuk tujuan ini kecuali benar-benar diperlukan untuk menggabungkan informasi HKEY_CLASSES_ROOT pengguna.
Aplikasi yang berjalan dalam konteks keamanan pengguna yang masuk secara interaktif tidak perlu menggunakan RegOpenUserClassesRoot. Aplikasi ini dapat memanggil fungsi RegOpenKeyEx untuk mengambil tampilan gabungan kunci HKEY_CLASSES_ROOT untuk pengguna interaktif.
Persyaratan
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | winreg.h (termasuk Windows.h) |
| Pustaka | Advapi32.lib |
| DLL | Advapi32.dll |