NPI_PROVIDER_CLEANUP_BINDING_CONTEXT_FN回调函数 (netioddk.h)

提供程序模块的 ProviderCleanupBindingContext 回调函数在提供程序模块和客户端模块彼此分离后执行提供程序模块绑定上下文的任何必要的清理和解除分配。

语法

NPI_PROVIDER_CLEANUP_BINDING_CONTEXT_FN NpiProviderCleanupBindingContextFn;

void NpiProviderCleanupBindingContextFn(
  [in] PVOID ProviderBindingContext
)
{...}

参数

[in] ProviderBindingContext

指向提供程序模块上下文的指针,用于在提供程序模块与从中分离的客户端模块之间的绑定。 提供程序模块的 ProviderAttachClient 回调函数在附加到客户端模块时返回指向 NMR 的指针。

返回值

没有

言论

NMR 调用提供程序模块的 ProviderCleanupBindingContext 回调函数后,提供程序和客户端模块彼此分离。

提供程序模块的 ProviderCleanupBindingContext 回调函数应对提供程序模块绑定上下文结构中包含的数据执行任何必要的清理。 如果提供程序模块动态分配了结构的内存,则它应释放绑定上下文结构的内存。

如果提供程序模块没有为其绑定上下文动态分配内存,并且不需要对其绑定上下文进行其他清理,则提供程序模块不需要实现 ProviderCleanupBindingContext 回调函数。 如果提供程序模块未实现 ProviderCleanupBindingContext 回调函数,则必须设置 ProviderCleanupBindingContext 成员调用 NmrRegisterProvider 函数以向 NMR 注册自身时, NPI_PROVIDER_CHARACTERISTICS 结构 NULL

NMR 在任何 IRQL <= DISPATCH_LEVEL 调用提供程序模块的 ProviderCleanupBindingContext 回调函数。

要求

要求 价值
最低支持的客户端 在 Windows Vista 和更高版本的 Windows作系统中可用。
目标平台 窗户
标头 netioddk.h (包括 Wsk.h)
IRQL <= DISPATCH_LEVEL

另请参阅

ClientDetachProvider

NPI_PROVIDER_CHARACTERISTICS

ProviderAttachClient

ProviderDetachClient