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 程式代碼:
傳回碼 | 描述 |
---|---|
|
用戶端模組已成功從提供者模組中斷連結。 |
|
用戶端模組無法立即與提供者模組中斷連結。 |
言論
每當用戶端模組與提供者模組之間的系結需要終止時,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 |