Fungsi ORSaveHive

Artikel
06/13/2023

Menulis sarang registri offline yang ditentukan ke file.

Sintaks

DWORD ORSaveHive(
  _In_ ORHKEY Handle,
  _In_ PCWSTR lpHivePath,
  _In_ DWORD  dwOsMajorVersion,
  _In_ DWORD  dwOsMinorVersion
);

Parameter

Handel [in]

Handel ke sarang registri offline untuk disimpan.

lpHivePath [in]

Penunjuk ke string Unicode yang menentukan nama file sarang registri. Ini tidak boleh menjadi nama file yang ada.

dwOsMajorVersion [in]

Nomor versi utama sistem operasi. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
5	Jika dwOsMinorVersion adalah 1, sistem operasinya adalah Windows XP. Jika dwOsMinorVersion adalah 2, sistem operasinya adalah Windows Server 2003 R2, Windows Server 2003, atau Windows XP Professional x64 Edition.
6	Jika dwOsMinorVersion adalah 0, sistem operasinya adalah Windows Server 2008 atau Windows Vista. Jika dwOsMinorVersion adalah 1, sistem operasinya adalah Windows Server 2008 R2 atau Windows 7.

dwOsMinorVersion [in]

Nomor versi minor dari sistem operasi. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
0	Jika dwOsMajorVersion adalah 6, sistem operasinya adalah Windows Server 2008 atau Windows Vista.
1	Jika dwOsMajorVersion adalah 5, sistem operasinya adalah Windows XP. Jika dwOsMajorVersion adalah 6, sistem operasinya adalah Windows Server 2008 R2 atau Windows 7.
2	Jika dwOsMajorVersion adalah 5, sistem operasinya adalah Windows Server 2003 R2, Windows Server 2003, atau Windows XP Professional x64 Edition. Jika dwOsMajorVersion adalah 6, parameter dwOsMinorVersion harus 0 atau 1.

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. Kemungkinan kode kesalahan meliputi yang berikut ini:

Jika penelepon tidak memiliki hak akses yang diperlukan untuk menulis file, fungsi mengembalikan ERROR_ACCESS_DENIED.
Jika file yang ditentukan sudah ada, fungsi mengembalikan ERROR_ALREADY_EXISTS.

Keterangan

Fungsi ORSaveHive harus digunakan untuk menyimpan perubahan yang dilakukan pada sarang registri offline. Perubahan tidak dipertahankan sampai ORSaveHive dipanggil untuk menyimpan sarang ke file.

Parameter dwOsMajorVersion dan dwOsMinorVersion bersama-sama menentukan format target file hive registri. Tabel berikut ini meringkas nomor versi sistem operasi terbaru.

Sistem operasi	Nomor Versi
Windows Server 2008 R2	6.1
Windows 7	6.1
Windows Server 2008	6.0
Windows Vista	6.0
Windows Server 2003 R2	5.2
Windows Server 2003	5.2
Windows XP Professional x64 Edition	5.2
Windows XP	5.1

Gunakan fungsi GetVersionEx untuk mengambil informasi tentang sistem operasi saat ini.

Fungsi ORSaveHive mengunci sarang registri saat menulis sarang ke file, lalu menutup file dan melepaskan kunci. Sarang registri tetap dalam memori sampai ditutup dengan memanggil fungsi ORCloseHive . Dimungkinkan untuk membuat perubahan lebih lanjut pada sarang registri saat terbuka; namun, untuk mempertahankan perubahan ini, sarang harus disimpan ke file baru, karena fungsi ORSaveHive tidak akan menimpa file yang ada.

Fungsi ORSaveHive dapat digunakan untuk menyimpan bagian dari sarang registri offline. Kunci yang ditentukan dalam parameter Handle menjadi kunci akar sarang yang terdiri dari kunci yang ditentukan dan semua subkuntangannya.

Persyaratan

Persyaratan	Nilai
Redistribusi	Pustaka Windows Offline Registry versi 1.0 atau yang lebih baru
Header	Offreg.h
DLL	Offreg.dll

Lihat juga

GetVersionEx
ORCloseHive
OROpenHive

Bagikan melalui