Fungsi NmrDeregisterClient (netioddk.h)

Artikel
08/07/2023

Fungsi NmrDeregisterClient membatalkan pendaftaran modul klien dari NMR.

Sintaks

NTSTATUS NmrDeregisterClient(
  [in] HANDLE NmrClientHandle
);

Parameter

[in] NmrClientHandle

Handel yang digunakan oleh NMR untuk mewakili pendaftaran modul klien. NMR mengembalikan handel ini ke modul klien saat modul klien memanggil fungsi NmrRegisterClient .

Nilai kembali

Fungsi NmrDeregisterClient mengembalikan salah satu kode NTSTATUS berikut:

Menampilkan kode	Deskripsi
STATUS_PENDING	NMR memulai deregistrasi modul klien. Modul klien harus memanggil Fungsi NmrWaitForClientDeregisterComplete untuk menunggu sampai deregistrasi selesai sebelum modul klien dapat dibongkar.
Kode status lainnya	Terjadi kesalahan.

Keterangan

Ketika modul klien memanggil fungsi NmrDeregisterClient , NMR memanggil fungsi panggilan balik ClientDetachProvider modul klien dan fungsi panggilan balik ProviderDetachClient modul penyedia untuk setiap pengikatan antara modul klien dan modul penyedia. Deregistrasi modul klien dari NMR selesai setelah modul klien berhasil terlepas dari semua modul penyedia tempat modul dilampirkan dan semua modul penyedia tersebut telah berhasil terlepas dari modul klien.

Modul klien biasanya memanggil fungsi NmrDeregisterClient dari fungsi Unload-nya untuk melepaskan dirinya dari semua modul penyedia yang dilampirkan sebelum modul klien dibongkar dari sistem. Setelah memanggil fungsi NmrDeregisterClient , modul klien harus memanggil Fungsi NmrWaitForClientDeregisterComplete menunggu deregistrasi selesai sebelum modul klien dapat dibongkar. Modul klien tidak boleh kembali dari panggilan ke fungsi Bongkar sampai setelah deregistrasi selesai.

Catatan Jika modul klien menggunakan Windows Driver Framework, biasanya akan memanggil fungsi NmrDeregisterClient dari fungsi panggilan balik peristiwa EvtDriverUnload . Dalam situasi ini, modul klien tidak boleh kembali dari panggilan ke fungsi EvtDriverUnload sampai setelah deregistrasi selesai.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Desktop
Header	netioddk.h (termasuk Wsk.h)
Pustaka	Netio.lib
IRQL	<= DISPATCH_LEVEL