Fungsi RegOpenUserClassesRoot (winreg.h)

Artikel
03/08/2023

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