Fungsi ZwDeleteKey (wdm.h)
Rutinitas ZwDeleteKey menghapus kunci terbuka dari registri.
Sintaks
NTSYSAPI NTSTATUS ZwDeleteKey(
[in] HANDLE KeyHandle
);
Parameter
[in] KeyHandle
Tangani ke kunci registri yang akan dihapus. Handel dibuat oleh panggilan yang berhasil ke ZwCreateKey atau ZwOpenKey.
Nilai kembali
ZwDeleteKey mengembalikan nilai NTSTATUS. Kemungkinan nilai yang dikembalikan meliputi:
STATUS_SUCCESS
STATUS_ACCESS_DENIED
STATUS_INVALID_HANDLE
STATUS_CANNOT_DELETE (lihat Keterangan)
Keterangan
Sebelum memanggil ZwDeleteKey, pastikan bahwa semua kunci dan nilai di bawah kunci yang diberikan telah dihapus. Hapus setiap subkunjuk terlebih dahulu, dimulai dengan kunci daun dan jalan ke atas.
Handel harus dibuka agar akses DELETE agar rutinitas ini berhasil. Untuk informasi selengkapnya, lihat parameter DesiredAccess untuk ZwCreateKey.
Panggilan ke ZwDeleteKey menyebabkan handel yang ditentukan dalam parameter KeyHandle —dan semua handel lainnya ke kunci yang dihapus—menjadi tidak valid. Setelah panggilan ke ZwDeleteKey membatalkan handel kunci, Anda harus memanggil ZwClose untuk menutup handel kunci.
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 "NtDeleteKey" alih-alih "ZwDeleteKey".
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), PowerIrpDDis(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