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

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

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

構文

NPI_PROVIDER_DETACH_CLIENT_FN NpiProviderDetachClientFn;

NTSTATUS NpiProviderDetachClientFn(
  [in] PVOID ProviderBindingContext
)
{...}

パラメーター

[in] ProviderBindingContext

プロバイダーモジュールとデタッチ元のクライアントモジュールとの間のバインドに対するプロバイダーモジュールのコンテキストへのポインター。プロバイダーモジュールの ProviderAttachClient コールバック関数は、クライアントモジュールにアタッチするときに、このポインターを NMR に返します。

戻り値

プロバイダーモジュールの ProviderDetachClient コールバック関数は、次のいずれかの NTSTATUS コードを返します。

リターンコード	説明
STATUS_SUCCESS	プロバイダーモジュールがクライアントモジュールから正常にデタッチされました。
STATUS_PENDING	プロバイダーモジュールをクライアントモジュールからすぐにデタッチできませんでした。

注釈

NMR は、プロバイダーモジュールとクライアントモジュール間のバインドを終了する必要がある場合は常に、プロバイダーモジュールの ProviderDetachClient コールバック関数を呼び出します。デタッチは、 NmrDeregisterClient 関数を呼び出すクライアントモジュールまたは NmrDeregisterProvider 関数を呼び出すプロバイダーモジュールによって開始されます。

ProviderDetachClient コールバック関数が呼び出された後、プロバイダーモジュールは、クライアントモジュールの NPI コールバック関数をこれ以上呼び出さないでください。プロバイダーモジュールの ProviderDetachClient コールバック関数が呼び出されたときに、クライアントモジュールの NPI コールバック関数の呼び出しが進行中でない場合、プロバイダーモジュールの ProviderDetachClient コールバック関数はSTATUS_SUCCESSを返します。

プロバイダーモジュールの ProviderDetachClient コールバック関数が呼び出されたときに、1 つ以上のクライアントモジュールの NPI コールバック関数の呼び出しが進行中の場合、プロバイダーモジュールの ProviderDetachClient コールバック関数はSTATUS_PENDINGを返します。この状況では、プロバイダーモジュールはを呼び出す必要があります。クライアントモジュールの NPI コールバック関数に対するすべての進行中の呼び出しが完了した後の NmrProviderDetachClientComplete 関数。への呼び出し NmrProviderDetachClientComplete 関数は、クライアントモジュールからのデタッチが完了したことを NMR に通知します。

NMR は、クライアントモジュールのを呼び出します。 ClientCleanupBindingContext コールバック関数とプロバイダーモジュールのクライアントモジュールとプロバイダーモジュールの両方のデタッチが完了した後の ProviderCleanupBindingContext コールバック関数。

NMR は、プロバイダーモジュールの ProviderDetachClient コールバック関数を IRQL <= DISPATCH_LEVELで呼び出します。

要件

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