Fungsi ZwFlushKey (wdm.h)

Rutinitas ZwFlushKey memaksa kunci registri untuk diterapkan ke disk.

Sintaks

NTSYSAPI NTSTATUS ZwFlushKey(
  [in] HANDLE KeyHandle
);

Parameter

[in] KeyHandle

Tangani ke kunci registri untuk dibersihkan ke disk. Handel ini dibuat oleh panggilan yang berhasil ke ZwCreateKey atau ZwOpenKey.

Nilai kembali

ZwFlushKey mengembalikan STATUS_SUCCESS jika informasi kunci ditransfer ke disk, atau kode kesalahan yang sesuai pada kegagalan.

Keterangan

Anda dapat menghapus perubahan yang dibuat oleh ZwCreateKey atau ZwSetValueKey dengan memanggil ZwFlushKey. Rutinitas ini tidak kembali sampai semua data yang diubah yang terkait dengan KeyHandle telah ditulis ke disk. ZwFlushKey membersihkan seluruh sarang registri untuk kunci, yang mencakup setiap subkunci kunci yang ditentukan.

Rutinitas ini dapat membersihkan seluruh registri. Dengan demikian, itu dapat menghasilkan banyak I/O. Karena sistem membersihkan kunci berubah secara otomatis setiap beberapa detik, Anda jarang perlu memanggil ZwFlushKey.

Untuk informasi selengkapnya tentang bekerja dengan kunci registri, lihat Menggunakan Registri di Driver.

Jika panggilan ke fungsi ini terjadi dalam mode pengguna, Anda harus menggunakan nama "NtFlushKey" alih-alih "ZwFlushKey".

Untuk panggilan dari driver mode kernel, versi NtXxx dan ZwXxx dari rutinItas Windows Native System Services dapat berperilaku berbeda dalam cara mereka menangani dan menginterpretasikan parameter input. Untuk informasi selengkapnya tentang hubungan antara versi NtXxx dan ZwXxx dari rutinitas, lihat Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs(storport), IrqlZwPassive(wdm), ZwRegistryCreate(storport), ZwRegistryCreate(storport), ZwRegistryCreate(wdm), ZwRegistryOpen(storport), ZwRegistryOpen(storport), ZwRegistryOpen(wdm)

Lihat juga

Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli

ZwCreateKey

ZwOpenKey

ZwSetValueKey