NPI_CLIENT_ATTACH_PROVIDER_FN fungsi panggilan balik (netioddk.h)

Artikel
08/07/2023

Fungsi panggilan balik ClientAttachProvider modul klien melampirkan modul klien ke modul penyedia.

Sintaks

NPI_CLIENT_ATTACH_PROVIDER_FN NpiClientAttachProviderFn;

NTSTATUS NpiClientAttachProviderFn(
  [in] HANDLE NmrBindingHandle,
  [in] PVOID ClientContext,
  [in] PNPI_REGISTRATION_INSTANCE ProviderRegistrationInstance
)
{...}

Parameter

[in] NmrBindingHandle

Handel yang digunakan oleh NMR untuk mewakili pengikatan antara modul klien dan modul penyedia.

[in] ClientContext

Penunjuk ke konteks pendaftaran modul klien. Modul klien meneruskan pointer ini ke NMR ketika memanggil fungsi NmrRegisterClient untuk mendaftarkan dirinya dengan NMR.

[in] ProviderRegistrationInstance

Penunjuk ke NPI_REGISTRATION_INSTANCE struktur. Struktur ini berisi data pendaftaran modul penyedia.

Nilai kembali

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

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Modul klien dan modul penyedia berhasil dilampirkan satu sama lain.
STATUS_NOINTERFACE	Modul klien tidak melampirkan ke modul penyedia atau modul penyedia tidak melampirkan ke modul klien.
Kode status lainnya	Terjadi kesalahan.

Keterangan

Setelah modul klien terdaftar di NMR, NMR memanggil fungsi panggilan balik ClientAttachProvider modul klien, sekali untuk setiap modul penyedia yang terdaftar sebagai penyedia NPI yang sama yang modul kliennya telah terdaftar sebagai klien.

NMR juga memanggil fungsi panggilan balik ClientAttachProvider modul klien setiap kali modul jaringan baru mendaftar sebagai penyedia NPI yang sama yang modul kliennya telah terdaftar sebagai klien.

Modul klien dapat memeriksa data pendaftaran modul penyedia. Data ini berada dalam struktur yang ditunjukkan oleh parameter ProviderRegistrationInstance . Modul klien menggunakan data ini untuk menentukan apakah modul akan dilampirkan ke modul penyedia:

Jika modul klien menentukan bahwa modul akan dilampirkan ke modul penyedia, maka fungsi panggilan balik ClientAttachProvider memanggil fungsi NmrClientAttachProvider untuk melanjutkan proses lampiran. Dalam situasi ini fungsi panggilan balik ClientAttachProvider harus mengembalikan kode status yang dikembalikan oleh panggilan ke Fungsi NmrClientAttachProvider .
Jika modul klien menentukan bahwa modul tidak akan dilampirkan ke modul penyedia, maka fungsi panggilan balik ClientAttachProvider harus mengembalikan STATUS_NOINTERFACE.

Jika modul klien berhasil dilampirkan ke modul penyedia, modul harus menyimpan handel yang disediakan dalam parameter NmrBindingHandle . Modul klien meneruskan handel ini sebagai parameter ke Fungsi NmrClientDetachProviderComplete saat terlepas dari modul penyedia.

NMR memanggil fungsi panggilan balik ClientAttachProvider modul klien di IRQL = PASSIVE_LEVEL.

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	PASSIVE_LEVEL