Fungsi RegOpenKeyA (winreg.h)

Artikel
03/13/2024

Membuka kunci registri yang ditentukan.

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

Sintaks

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 RegOpenKeyEx , atau dapat menjadi salah satu kunci yang telah ditentukan sebelumnya berikut:

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 merupakan subkuntangan kunci yang diidentifikasi oleh parameter hKey .

Nama kunci tidak peka huruf besar/kecil.

Jika parameter ini null atau pointer 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 kuncinya bukan salah satu kunci registri yang telah ditentukan sebelumnya, panggil fungsi RegCloseKey setelah Anda selesai menggunakan handel.

Nilai kembali

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

Catatan

Header winreg.h mendefinisikan RegOpenKey sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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

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	winreg.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll

Lihat juga

Gambaran Umum Registri