NPI_CLIENT_CLEANUP_BINDING_CONTEXT_FN回呼函式 (netioddk.h)

發行項
02/26/2024

用戶端模組的 ClientCleanupBindingContext 回呼 函式會在用戶端模組和提供者模組彼此中斷連結之後，執行用戶端模組系結內容的任何必要清除和解除分配。

語法

NPI_CLIENT_CLEANUP_BINDING_CONTEXT_FN NpiClientCleanupBindingContextFn;

void NpiClientCleanupBindingContextFn(
  [in] PVOID ClientBindingContext
)
{...}

參數

[in] ClientBindingContext

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

傳回值

無

備註

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

用戶端模組的 ClientCleanupBindingContext 回呼 函式應該執行用戶端模組系結內容結構內所含數據的任何必要清除。如果用戶端模組動態配置結構的記憶體，它應該釋放系結內容結構的記憶體。

如果用戶端模組未針對系結內容動態配置記憶體，而且不需要其他清除其系結內容，則用戶端模組不需要實作 ClientCleanupBindingContext 回呼 函式。如果用戶端模組未實作 ClientCleanupBindingContext 回呼函式，則必須設定的 ClientCleanupBindingContext 成員當它呼叫NmrRegisterClient函式以向NMR註冊本身時，NPI_CLIENT_CHARACTERISTICS結構為NULL。

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

規格需求

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