FUNGSI ORSetVirtualFlags

Mengatur bendera virtualisasi pada kunci registri terbuka yang ditentukan dalam sarang registri offline.

Sintaks

DWORD ORSetVirtualFlags(
  _In_ ORHKEY Handle,
  _In_ DWORD  dwFlags
);

Parameter

Handel [in]

Handel ke kunci registri terbuka di sarang registri offline.

dwFlags [in]

Parameter ini mengontrol perilaku registri saat operasi Buat atau Buka gagal pada kunci dalam sarang virtual. Parameter ini bisa menjadi satu atau beberapa nilai berikut.

Nilai	Makna
REG_KEY_DONT_SILENT_FAIL 4	Jika bendera ini diatur dan operasi Buka gagal pada kunci yang virtualisasinya diaktifkan, registri tidak mencoba membuka kembali kunci. Jika bendera ini jelas, registri mencoba membuka kembali kunci dengan akses MAXIMUM_ALLOWED.
REG_KEY_DONT_VIRTUALIZE 2	Jika bendera ini diatur dan operasi Buat Kunci gagal karena pemanggil tidak memiliki KEY_CREATE_SUB_KEY langsung pada kunci induk, registri gagal membuat operasi. Jika bendera ini jelas, registri mencoba membuat kunci di penyimpanan virtual. Pemanggil harus memiliki KEY_READ tepat di kunci induk.
REG_KEY_RECURSE_FLAG 8	Jika bendera ini diatur, bendera virtualisasi registri disebarluaskan dari kunci induk. Jika bendera ini jelas, bendera virtualisasi registri tidak disebarluaskan.

 

Nilai kembali

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.

Keterangan

Virtualisasi registri adalah teknologi kompatibilitas aplikasi sementara yang memungkinkan operasi penulisan registri yang memiliki dampak global untuk dialihkan ke lokasi per pengguna. Pengalihan ini transparan untuk aplikasi yang membaca dari atau menulis ke registri.

Virtualisasi registri didukung dimulai dengan Windows Vista. Namun, Microsoft berniat untuk menghapusnya dari versi sistem operasi Windows di masa mendatang karena lebih banyak aplikasi dibuat kompatibel dengan Windows Vista. Oleh karena itu, aplikasi tidak boleh bergantung pada perilaku virtualisasi registri dalam sistem.

Virtualisasi registri diaktifkan hanya untuk hal berikut:

• Proses interaktif 32-bit
• Kunci dalam HKEY_LOCAL_MACHINE\Software
• Kunci yang dapat ditulis administrator

Untuk informasi selengkapnya, lihat Virtualisasi Registri.

Persyaratan

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

Lihat juga

ORGetVirtualFlags

Virtualisasi Registri