NPI_CLIENT_CLEANUP_BINDING_CONTEXT_FN回呼函式 (netioddk.h)
用戶端模組的 ClientCleanupBindingContext 回呼函式會在用戶端模組和提供者模組彼此中斷鏈接之後,執行用戶端模組系結內容的任何必要清除和解除分配。
語法
NPI_CLIENT_CLEANUP_BINDING_CONTEXT_FN NpiClientCleanupBindingContextFn;
void NpiClientCleanupBindingContextFn(
[in] PVOID ClientBindingContext
)
{...}
參數
[in] ClientBindingContext
用戶端模組內容指標,用於用戶端模組與其中斷連結的提供者模組之間的系結。 用戶端模組會在呼叫 NmrClientAttachProvider 函式以附加至提供者模組時,將此指標傳遞給 NMR。
傳回值
沒有
言論
NMR 會在用戶端模組和提供者模組彼此中斷鏈接之後,呼叫用戶端模組的 ClientCleanupBindingContext 回呼函式。
用戶端模組的 ClientCleanupBindingContext 回呼函式應該執行用戶端模組系結內容結構內所含數據的任何必要清除。 如果用戶端模組動態配置結構的記憶體,則它應該釋放系結內容結構的記憶體。
如果用戶端模組不會動態配置其系結內容的記憶體,而且不需要對其系結內容進行其他清除,則客戶端模組不需要實作 ClientCleanupBindingContext 回呼函式。 如果用戶端模組未實作 ClientCleanupBindingContext 回呼函式,則必須設定 ClientCleanupBindingContext 成員 NPI_CLIENT_CHARACTERISTICS 結構,以在呼叫 NmrRegisterClient 函式以向 NMR 註冊本身時,NULL。
NMR 會在任何 IRQL <= DISPATCH_LEVEL 呼叫用戶端模組的 ClientCleanupBindingContext 回呼函式。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows作系統中使用。 |
目標平臺 | 窗戶 |
標頭 | netioddk.h (包括 Wsk.h) |
IRQL | <= DISPATCH_LEVEL |