Fungsi RegOpenKeyA (winreg.h)

Artikel
11/20/2024

Membuka kunci registri yang ditentukan.

Catatan Fungsi ini disediakan hanya untuk kompatibilitas dengan Windows versi 16-bit. Aplikasi harus menggunakan fungsi RegOpenKeyEx .

Sintaksis

LSTATUS RegOpenKeyA(
  [in]           HKEY   hKey,
  [in, optional] LPCSTR lpSubKey,
  [out]          PHKEY  phkResult
);

Parameter

[in] hKey

Handel ke kunci registri terbuka. Handel ini dikembalikan oleh fungsi RegCreateKeyEx atau Fungsi RegOpenKeyEx, atau dapat menjadi salah satu kunci berikut yang telah ditentukan sebelumnya:

HKEY_CLASSES_ROOT
HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS

[in, optional] lpSubKey

Nama kunci registri yang akan dibuka. Kunci ini harus berupa subkunji kunci yang diidentifikasi oleh parameter hKey .

Nama kunci tidak peka huruf besar/kecil.

Jika parameter ini null atau penunjuk ke string kosong, fungsi mengembalikan handel yang sama yang diteruskan.

Untuk informasi selengkapnya, lihat Batas Ukuran Elemen Registri.

[out] phkResult

Penunjuk ke variabel yang menerima handel ke kunci yang dibuka. Jika kunci bukan salah satu kunci registri yang telah ditentukan sebelumnya, panggil fungsi RegCloseKey setelah Anda selesai menggunakan handel.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika fungsi gagal, nilai pengembalian adalah kode kesalahan nonzero yang ditentukan dalam Winerror.h. Anda dapat menggunakan fungsi FormatMessage dengan bendera FORMAT_MESSAGE_FROM_SYSTEM untuk mendapatkan deskripsi umum tentang kesalahan tersebut.

Komentar

Fungsi RegOpenKey menggunakan masker akses keamanan default untuk membuka kunci. Jika membuka kunci memerlukan hak akses yang berbeda, fungsi gagal, mengembalikan ERROR_ACCESS_DENIED. Aplikasi harus menggunakan fungsi RegOpenKeyEx untuk menentukan masker akses dalam situasi ini.

RegOpenKey tidak membuat kunci yang ditentukan jika kunci tidak ada di database.

Jika layanan atau aplikasi Anda meniru pengguna yang berbeda, jangan gunakan fungsi ini dengan HKEY_CURRENT_USER. Sebagai gantinya, panggil fungsi RegOpenCurrentUser.

Nota

Header winreg.h mendefinisikan RegOpenKey sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	winreg.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll

Lihat juga

RegCloseKey

regDeleteKey

RegOpenKeyEx

Fungsi Registri

Gambaran Umum Registri

Bagikan melalui