Bagikan melalui


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
Offreg.h
DLL
Offreg.dll

Lihat juga

ORCloseKey

ORCreateKey

ORDeleteKey

OROpenHive