Fungsi OROpenKey
Membuka kunci registri yang ditentukan dalam sarang registri offline.
Sintaks
DWORD OROpenKey(
_In_ ORHKEY Handle,
_In_opt_ PCWSTR lpSubKeyName,
_Out_ PORHKEY phkResult
);
Parameter
-
Handel [in]
-
Handel ke kunci registri terbuka di sarang registri offline.
-
lpSubKeyName [in, opsional]
-
Penunjuk ke string UNICODE yang berisi nama kunci registri yang akan dibuka. Kunci ini harus berupa subkunji kunci yang diidentifikasi oleh parameter Handel .
Nama kunci tidak peka huruf besar/kecil.
Jika parameter ini NULL atau penunjuk ke string kosong, fungsi mengembalikan handel yang sama yang diteruskan. Jika kunci yang ditentukan oleh parameter Handel adalah kunci akar sarang, fungsi mengembalikan ERROR_INVALID_PARAMETER.
Untuk informasi selengkapnya, lihat Batas Ukuran Elemen Registri.
-
phkResult [out]
-
Penunjuk ke variabel yang menerima handel ke kunci yang dibuka. Gunakan fungsi ORCloseKey untuk menutup kunci setelah Anda selesai menggunakan handel.
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.
Jika handel yang akan dikembalikan adalah handel ke kunci akar sarang, fungsi mengembalikan ERROR_INVALID_PARAMETER.
Jika kunci yang ditentukan telah ditandai sebagai dihapus, fungsi ini akan mengembalikan ERROR_KEY_DELETED.
Keterangan
Fungsi OROpenKey tidak dapat digunakan untuk membuka kunci akar dalam sarang registri offline. Untuk mendapatkan handel ke kunci akar sarang, gunakan fungsi OROpenHive untuk memuat sarang ke dalam memori.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Redistribusi |
Pustaka Windows Offline Registry versi 1.0 atau yang lebih baru |
| Header |
|
| DLL |
|
Lihat juga