fwpsCalloutUnregisterById0 函数 (fwpsk.h)

FwpsCalloutUnregisterById0 函数从筛选器引擎取消注册标注。

注意FwpsCalloutUnregisterById0FwpsCalloutUnregisterById 的特定版本。 有关详细信息 ,请参阅粮食计划署Version-Independent名称和面向特定版本的 Windows
 

语法

NTSTATUS FwpsCalloutUnregisterById0(
  [in] const UINT32 calloutId
);

参数

[in] calloutId

要从筛选器引擎注销的标注的运行时标识符。 这必须是调用 FwpsCalloutRegister0FwpsCalloutRegister1 函数以向筛选器引擎注册标注时返回的运行时标识符。

返回值

FwpsCalloutUnregisterById0 函数返回以下 NTSTATUS 代码之一。

返回代码 说明
STATUS_SUCCESS
从筛选器引擎成功注销标注。
STATUS_DEVICE_BUSY
标注处理了一个或多个数据流,这些数据流具有与数据流关联的未完成上下文。 标注驱动程序必须为每个数据流调用 FwpsFlowRemoveContext0 函数才能删除关联的上下文。 成功从其中每个数据流中删除上下文后,标注驱动程序必须再次调用 FwpsCalloutUnregisterById0 函数才能从筛选器引擎取消注册标注。
STATUS_FWP_CALLOUT_NOT_FOUND
没有与 calloutId 参数中指定的运行时标识符匹配的筛选器引擎注册的标注。
STATUS_FWP_IN_USE
标注已在另一个线程中注册或注销。
其他状态代码
出现了错误。

注解

标注驱动程序调用 FwpsCalloutUnregisterById0 函数,以从筛选器引擎注销标注,使用运行时标识符标识要注销的标注。 即使筛选器引擎中有指定筛选器操作标注的筛选器,此函数也会成功。 在这种情况下,具有操作类型的筛选器FWP_ACTION_CALLOUT_TERMINATINGFWP_ACTION_CALLOUT_UNKNOWN被视为FWP_ACTION_BLOCK,在从筛选器引擎注销标注后,将忽略具有FWP_ACTION_CALLOUT_INSPECTION操作类型的筛选器。

在已成功注销之前向筛选器引擎注册的所有标注之前,无法卸载标注驱动程序。

要求

   
最低受支持的客户端 从 Windows Vista 开始可用。
目标平台 通用
标头 fwpsk.h (包括 Fwpsk.h)
Library Fwpkclnt.lib
IRQL PASSIVE_LEVEL

另请参阅

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsCalloutUnregisterByKey0

FwpsFlowRemoveContext0

标注类型