NPI_CLIENT_DETACH_PROVIDER_FN回呼函式 (netioddk.h)

發行項
02/29/2024

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

語法

NPI_CLIENT_DETACH_PROVIDER_FN NpiClientDetachProviderFn;

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

參數

[in] ClientBindingContext

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

傳回值

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

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

備註

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

呼叫 ClientDetachProvider 回 呼函式之後，用戶端模組不應該對任何提供者模組的 NPI 函式進行更多呼叫。如果呼叫用戶端模組的 ClientDetachProvider 回呼函式時，沒有任何提供者模組 NPI 函式的進行中呼叫，用戶端模組的 ClientDetachProvider 回呼函式會傳回STATUS_SUCCESS。

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

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

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

規格需求

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