Fungsi WdfRegistryRemoveKey (wdfregistry.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfRegistryRemoveKey menghapus kunci registri yang terkait dengan objek kunci registri kerangka kerja tertentu lalu menghapus objek kunci registri.

Sintaks

NTSTATUS WdfRegistryRemoveKey(
  [in] WDFKEY Key
);

Parameter

[in] Key

Handel ke objek kunci registri yang mewakili kunci registri yang dibuka.

Nilai kembali

WdfRegistryRemoveKey mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, metode mungkin mengembalikan salah satu nilai berikut:

Menampilkan kode Deskripsi
STATUS_INVALID_DEVICE_REQUEST

WdfRegistryRemoveKey tidak dipanggil di IRQL = PASSIVE_LEVEL.
STATUS_ACCESS_DENIED
 Driver tidak membuka kunci registri dengan akses penghapusan.
STATUS_NOT_IMPLEMENTED
 Lihat bagian Keterangan.
 

Metode ini juga dapat mengembalikan nilai NTSTATUS lainnya.

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Keterangan

Catatan

Sebelum memanggil WdfRegistryRemoveKey, 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.

Catatan  

Dari driver KMDF, jangan panggil WdfRegistryRemoveKey dan kemudian WdfRegistryClose pada kunci yang sama. WDFKEY tidak lagi valid setelah WdfRegistryRemoveKey kembali.

 
Meskipun legal bagi driver UMDF untuk memanggil WdfRegistryRemoveKey, panggilan selalu mengembalikan STATUS_NOT_IMPLEMENTED. Untuk menghapus objek WDFKEY, driver UMDF harus memanggil WdfRegistryClose.

Untuk informasi selengkapnya tentang objek kunci registri, lihat Menggunakan Registri di Driver Framework-Based.

Contoh

Contoh kode berikut menghapus kunci registri dan menghapus objek kunci registri.

NTSTATUS  status;

status = WdfRegistryRemoveKey(Key);

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfregistry.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)