共用方式為


NPI_CLIENT_DETACH_PROVIDER_FN回呼函式 (netioddk.h)

用戶端模組的 ClientDetachProvider 回呼函式會將用戶端模組與提供者模組中斷連結。

語法

NPI_CLIENT_DETACH_PROVIDER_FN NpiClientDetachProviderFn;

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

參數

[in] ClientBindingContext

用戶端模組內容指標,用於用戶端模組與其中斷連結之提供者模組之間的系結。 用戶端模組會在呼叫 NmrClientAttachProvider 函式以附加至提供者模組時,將此指標傳遞給 NMR。

傳回值

用戶端模組的 ClientDetachProvider 回呼函式會傳回下列其中一個 NTSTATUS 程式代碼:

傳回碼 描述
STATUS_SUCCESS
用戶端模組已成功從提供者模組中斷連結。
STATUS_PENDING
用戶端模組無法立即與提供者模組中斷連結。

言論

每當用戶端模組與提供者模組之間的系結需要終止時,NMR 會呼叫用戶端模組的 ClientDetachProvider 回呼函式。 卸離是由呼叫 NmrDeregisterClient 函式的用戶端模組或呼叫 NmrDeregisterProvider 函式的提供者模組起始。

呼叫用戶端模組 ClientDetachProvider 回呼函式之後,用戶端模組不應再呼叫任何提供者模組 NPI 函式。 如果呼叫用戶端模組 ClientDetachProvider 回呼函式時,沒有任何提供者模組 NPI 函式的進行中呼叫,則用戶端模組 的 clientDetachProvider 回呼函式會傳回STATUS_SUCCESS。

如果呼叫用戶端模組的用戶端模組 ClientDetachProvider 回呼函式時,對一或多個提供者模組 NPI 函式進行中的呼叫,則用戶端模組 的 clientDetachProvider 回呼函式會傳回STATUS_PENDING。 在此情況下,用戶端模組必須呼叫 NmrClientDetachProviderComplete 函式之後,提供者模組 NPI 函式的所有進行中呼叫都已完成。 對的呼叫 NmrClientDetachProviderComplete 函式會通知 NMR 中斷連結與提供者模組已完成。

NMR 會呼叫用戶端模組的 ClientCleanupBindingContext 回呼函式和提供者模組的 ProviderCleanupBindingContext 用戶端模組和提供者模組完成彼此中斷鏈接之後的回呼函式。

NMR 會在任何 IRQL = DISPATCH_LEVEL 呼叫用戶端模組的 < 回呼函式。

要求

要求 價值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows作系統中使用。
目標平臺 窗戶
標頭 netioddk.h (包括 Wsk.h)
IRQL <= DISPATCH_LEVEL

另請參閱

ClientCleanupBindingContext

NPI_CLIENT_CHARACTERISTICS

NmrClientAttachProvider

NmrClientDetachProviderComplete

NmrDeregisterClient

NmrDeregisterProvider

ProviderCleanupBindingContext