Fungsi RegOpenCurrentUser (winreg.h)

  • Artikel

Mengambil handel ke kunci HKEY_CURRENT_USER untuk pengguna yang ditiru oleh utas saat ini.

Sintaks

LSTATUS RegOpenCurrentUser(
  [in]  REGSAM samDesired,
  [out] PHKEY  phkResult
);

Parameter

[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.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan 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

Kunci HKEY_CURRENT_USER memetakan ke akar cabang pengguna saat ini di kunci HKEY_USERS . Ini di-cache untuk semua utas dalam proses. Oleh karena itu, nilai ini tidak berubah ketika profil pengguna lain dimuat. RegOpenCurrentUser menggunakan token utas untuk mengakses kunci yang sesuai, atau default jika profil tidak dimuat.

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

Lihat juga

RegCloseKey

Fungsi Registri

Gambaran Umum Registri