NPI_CLIENT_DETACH_PROVIDER_FN fungsi panggilan balik (netioddk.h)

Artikel
02/26/2024

Fungsi panggilan balik ClientDetachProvider modul klien melepaskan modul klien dari modul penyedia.

Sintaks

NPI_CLIENT_DETACH_PROVIDER_FN NpiClientDetachProviderFn;

NTSTATUS NpiClientDetachProviderFn(
  [in] PVOID ClientBindingContext
)
{...}

Parameter

[in] ClientBindingContext

Penunjuk ke konteks modul klien untuk pengikatan antara modul klien dan modul penyedia tempat modul dicopot. Modul klien meneruskan pointer ini ke NMR saat memanggil fungsi NmrClientAttachProvider untuk melampirkan ke modul penyedia.

Nilai kembali

Fungsi panggilan balik ClientDetachProvider modul klien mengembalikan salah satu kode NTSTATUS berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Modul klien berhasil dilepas dari modul penyedia.
STATUS_PENDING	Modul klien tidak dapat segera mencopot dari modul penyedia.

Keterangan

NMR memanggil fungsi panggilan balik ClientDetachProvider modul klien setiap kali pengikatan antara modul klien dan modul penyedia perlu dihentikan. Pencopotan dimulai oleh modul klien yang memanggil fungsi NmrDeregisterClient atau modul penyedia yang memanggil fungsi NmrDeregisterProvider .

Setelah fungsi panggilan balik ClientDetachProvider dipanggil, modul klien tidak boleh melakukan panggilan lagi ke salah satu fungsi NPI modul penyedia. Jika tidak ada panggilan yang sedang berlangsung ke salah satu fungsi NPI modul penyedia saat fungsi panggilan balik ClientDetachProvider modul klien dipanggil, fungsi panggilan balik ClientDetachProvider modul klien mengembalikan STATUS_SUCCESS.

Jika ada panggilan yang sedang berlangsung ke satu atau beberapa fungsi NPI modul penyedia saat fungsi panggilan balik ClientDetachProvider modul klien dipanggil, maka fungsi panggilan balik ClientDetachProvider modul klien mengembalikan STATUS_PENDING. Dalam situasi ini, modul klien harus memanggil Fungsi NmrClientDetachProviderComplete setelah semua panggilan yang sedang berlangsung ke fungsi NPI modul penyedia telah selesai. Panggilan ke Fungsi NmrClientDetachProviderComplete memberi tahu NMR bahwa pencopotan dari modul penyedia selesai.

NMR memanggil modul klienFungsi panggilan balik ClientCleanupBindingContext dan modul penyediaFungsi panggilan balik ProviderCleanupBindingContext setelah modul klien dan modul penyedia telah menyelesaikan pencopotan satu sama lain.

NMR memanggil fungsi panggilan balik ClientDetachProvider modul klien di IRQL <= DISPATCH_LEVEL apa pun.

Persyaratan

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