Fungsi ZwDeleteKey (wdm.h)

  • Artikel

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

ZwCreateKey

ZwOpenKey