Fungsi RegFlushKey (winreg.h)

Menulis semua atribut kunci registri terbuka yang ditentukan ke dalam registri.

Sintaks

LSTATUS RegFlushKey(
  [in] HKEY hKey
);

Parameter

[in] hKey

Handel ke kunci registri terbuka. Kunci harus telah dibuka dengan hak akses KEY_QUERY_VALUE. Untuk informasi selengkapnya, lihat Keamanan Kunci Registri dan Hak Akses.

Handel ini dikembalikan oleh fungsi RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyEx, atau RegOpenKeyTransacted . Ini juga bisa menjadi salah satu kunci yang telah ditentukan sebelumnya berikut:

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_PERFORMANCE_DATA

HKEY_USERS

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

Memanggil RegFlushKey adalah operasi mahal yang secara signifikan memengaruhi performa di seluruh sistem karena mengonsumsi bandwidth disk dan memblokir modifikasi ke semua kunci oleh semua proses di sarang registri yang sedang dibersihkan sampai operasi flush selesai. RegFlushKey hanya boleh dipanggil secara eksplisit ketika aplikasi harus menjamin bahwa perubahan registri dipertahankan ke disk segera setelah modifikasi. Semua modifikasi yang dilakukan pada kunci terlihat oleh proses lain tanpa perlu membersihkannya ke disk.

Atau, registri memiliki mekanisme 'malas flush' yang membersihkan modifikasi registri ke disk secara berkala. Selain operasi flush reguler ini, perubahan registri juga disiram ke disk saat sistem dimatikan. Memungkinkan 'malas flush' untuk membersihkan perubahan registri adalah cara paling efisien untuk mengelola penulisan registri ke penyimpanan registri pada disk.

Fungsi RegFlushKey hanya mengembalikan ketika semua data untuk sarang yang berisi kunci yang ditentukan telah ditulis ke penyimpanan registri pada disk.

Fungsi RegFlushKey menuliskan data untuk kunci lain di sarang yang telah dimodifikasi sejak flush malas terakhir atau sistem dimulai.

Setelah RegFlushKey kembali, gunakan RegCloseKey untuk menutup handel ke kunci registri.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winreg.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll

Lihat juga

RegCloseKey

RegDeleteKey

Fungsi Registri

Gambaran Umum Registri