Fungsi ZwDeleteValueKey (wdm.h)

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.

Mengembalikan nilai

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 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 .

Catatan 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

   
Klien minimum yang didukung Tersedia dimulai dengan Windows 2000.
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)

Lihat juga

Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli

ZwCreateKey

ZwDeleteKey

ZwEnumerateValueKey

ZwOpenKey

ZwQueryValueKey

ZwSetValueKey