Fungsi OROpenHive
Memuat file sarang registri yang ditentukan ke dalam memori dan memvalidasi sarang.
Sintaks
DWORD OROpenHive(
_In_ PCWSTR lpHivePath,
_Out_ PORHKEY phkResult
);
Parameter
-
lpHivePath [in]
-
Penunjuk ke string Unicode yang menentukan nama file sarang registri yang akan dimuat ke dalam memori. Ini bisa menjadi file hive yang disimpan dengan fungsi ORSaveHive atau dibuat dengan fungsi RegSaveKey atau RegSaveKeyEx . Ukuran file harus kurang dari 4 GB, dan pemanggil harus memiliki akses FILE_READ_DATA ke file. Untuk informasi selengkapnya, lihat Keamanan File dan Hak Akses.
-
phkResult [out]
-
Penunjuk ke variabel yang menerima handel ke kunci akar sarang registri offline yang dimuat. Jika file hive registri tidak dapat dibuka atau validasi gagal, fungsi mengatur parameter ini ke NULL.
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. Kode kesalahan yang mungkin termasuk yang berikut ini:
- Jika file kosong atau berukuran lebih besar dari 4 GB, fungsi akan mengembalikan ERROR_BADDB.
- Jika pemanggil tidak memiliki hak akses yang diperlukan untuk membuka file, fungsi akan mengembalikan ERROR_ACCESS_DENIED.
- Jika sarang registri gagal validasi, fungsi mengembalikan ERROR_NOT_REGISTRY_FILE.
Keterangan
Fungsi OROpenHive adalah satu-satunya fungsi registri offline yang memvalidasi sarang registri. Jika validasi gagal, tidak ada upaya yang dilakukan untuk memperbaiki sarang.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Redistribusi |
Pustaka Windows Offline Registry versi 1.0 atau yang lebih baru |
| Header |
|
| DLL |
|
Lihat juga