NPI_CLIENT_ATTACH_PROVIDER_FN コールバック関数 (netioddk.h)

[アーティクル]
08/07/2023

クライアントモジュールの ClientAttachProvider コールバック関数は、クライアントモジュールをプロバイダーモジュールにアタッチします。

構文

NPI_CLIENT_ATTACH_PROVIDER_FN NpiClientAttachProviderFn;

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

パラメーター

[in] NmrBindingHandle

クライアントモジュールとプロバイダーモジュールの間のバインドを表すために、NMR によって使用されるハンドル。

[in] ClientContext

クライアントモジュールの登録コンテキストへのポインター。クライアントモジュールは、 NmrRegisterClient 関数を呼び出して自身を NMR に登録するときに、このポインターを NMR に渡します。

[in] ProviderRegistrationInstance

へのポインター NPI_REGISTRATION_INSTANCE 構造体。この構造体には、プロバイダーモジュールの登録データが含まれています。

戻り値

クライアントモジュールの ClientAttachProvider コールバック関数は、次のいずれかの NTSTATUS コードを返します。

リターンコード	説明
STATUS_SUCCESS	クライアントモジュールとプロバイダーモジュールが正常に相互に接続されました。
STATUS_NOINTERFACE	クライアントモジュールがプロバイダーモジュールにアタッチされなかったか、プロバイダーモジュールがクライアントモジュールにアタッチされませんでした。
その他の状態コード	エラーが発生しました。

解説

クライアントモジュールが NMR に登録されると、クライアントモジュールがクライアントとして登録されているのと同じ NPI のプロバイダーとして登録されているプロバイダーモジュールごとに、クライアントモジュールの ClientAttachProvider コールバック関数が 1 回呼び出されます。

また、クライアントモジュールがクライアントとして登録されているのと同じ NPI のプロバイダーとして新しいネットワークモジュールが登録されるたびに、クライアントモジュールの ClientAttachProvider コールバック関数も呼び出されます。

クライアントモジュールは、プロバイダーモジュールの登録データを調べることができます。このデータは、 ProviderRegistrationInstance パラメーターによって指される構造にあります。クライアントモジュールは、このデータを使用して、プロバイダーモジュールにアタッチするかどうかを決定します。

クライアントモジュールがプロバイダーモジュールにアタッチすると判断した場合、 ClientAttachProvider コールバック関数は NmrClientAttachProvider 関数を呼び出して添付ファイルプロセスを続行します。この状況では、 ClientAttachProvider コールバック関数は、の呼び出しによって返される状態コードを返す必要があります。 NmrClientAttachProvider 関数。
クライアントモジュールがプロバイダーモジュールにアタッチしないと判断した場合、 ClientAttachProvider コールバック関数はSTATUS_NOINTERFACEを返す必要があります。

クライアントモジュールがプロバイダーモジュールに正常にアタッチされた場合は、 NmrBindingHandle パラメーターに指定されたハンドルを保存する必要があります。クライアントモジュールは、このハンドルをパラメーターとしてに渡します。プロバイダーモジュールからデタッチすると、NmrClientDetachProviderComplete 関数が実行されます。

NMR は、IRQL = PASSIVE_LEVELでクライアントモジュールの ClientAttachProvider コールバック関数を呼び出します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
対象プラットフォーム	Windows
ヘッダー	netioddk.h (Wsk.h を含む)
IRQL	PASSIVE_LEVEL