Fungsi ZwDeleteValueKey (wdm.h)

Artikel
03/08/2023

Rutinitas ZwDeleteValueKey menghapus entri nilai yang cocok dengan nama dari kunci terbuka di registri. Jika tidak ada entri seperti itu, kesalahan akan dikembalikan.

Sintaks

NTSYSAPI NTSTATUS ZwDeleteValueKey(
  [in] HANDLE          KeyHandle,
  [in] PUNICODE_STRING ValueName
);

Parameter

[in] KeyHandle

Handel ke kunci registri yang berisi entri nilai yang diminati. Kunci ini harus dibuka dengan KEY_SET_VALUE diatur untuk akses yang diinginkan. Handel ini dibuat oleh panggilan yang berhasil ke ZwCreateKey atau ZwOpenKey.

[in] ValueName

Penunjuk ke struktur UNICODE_STRING yang berisi nama entri nilai yang akan dihapus. Parameter ini bisa menjadi string kosong jika entri nilai tidak memiliki nama.

Nilai kembali

ZwDeleteValueKey mengembalikan STATUS_SUCCESS atau status kesalahan yang sesuai yang mewakili status penyelesaian akhir operasi. Kemungkinan kode status kesalahan meliputi yang berikut ini:

Menampilkan kode	Deskripsi
STATUS_ACCESS_DENIED	Handel KeyHandle tidak memiliki akses KEY_SET_VALUE.
STATUS_INSUFFICIENT_RESOURCES	Sumber daya tambahan yang diperlukan oleh fungsi ini tidak tersedia.
STATUS_INVALID_HANDLE	Parameter KeyHandle yang ditentukan adalah penunjuk NULL atau bukan penunjuk yang valid ke kunci registri terbuka.
STATUS_OBJECT_NAME_NOT_FOUND	Entri kunci registri ValueName tidak ditemukan.

Keterangan

KeyHandle yang diteruskan ke ZwDeleteValueKey harus telah dibuka agar akses penghapusan berhasil. Nilai DesiredAccess dari KEY_SET_VALUE, KEY_WRITE, dan KEY_ALL_ACCESS menyertakan masker akses KEY_SET_VALUE yang diperlukan untuk akses penghapusan. Untuk deskripsi nilai yang mungkin untuk DesiredAccess, lihat ZwCreateKey.

Jika fungsi panggilan balik terdaftar untuk kunci registri ini, maka fungsi panggilan balik ini akan dipanggil.

Driver perangkat tidak boleh mencoba memanggil ZwDeleteValueKey secara langsung untuk menghapus entri nilai dalam subkuntang dari \Registry.. \Kunci ResourceMap . Hanya sistem yang dapat menulis atau menghapus entri nilai di \Registry.. \Pohon HardwareDescription .

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

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, Fltkernel.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)