FwpsFlowRemoveContext0 函数 (fwpsk.h)

  • 项目

FwpsFlowRemoveContext0 函数从数据流中删除以前关联的上下文。

注意FwpsFlowRemoveContext0 是 FwpsFlowRemoveContext 的特定版本。 有关详细信息 ，请参阅 WFP Version-Independent 名称和面向特定版本的 Windows 。
 

语法

NTSTATUS FwpsFlowRemoveContext0(
  [in] UINT64 flowId,
  [in] UINT16 layerId,
  [in] UINT32 calloutId
);

参数

[in] flowId

一个运行时标识符，指定要从中删除上下文的数据流。 数据流的运行时标识符通过传递给标注驱动程序的 classifyFn 标注函数的FWPS_METADATA_FIELD_FLOW_HANDLE元数据值提供给标注驱动程序。

[in] layerId

要从中删除上下文的筛选层的运行时标识符。 有关详细信息，请参阅 运行时筛选层标识符。 标注驱动程序应指定与调用 FwpsFlowAssociateContext0 函数时指定的标识符相同的标识符，以便将上下文与数据流相关联。

[in] calloutId

筛选器引擎中标注的运行时标识符。 当标注驱动程序调用 FwpsCalloutRegister0 或 FwpsCalloutRegister1 函数以向筛选器引擎注册标注时，将返回此标识符。

返回值

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

返回代码 说明
STATUS_SUCCESS
 已成功从数据流中删除上下文。
STATUS_UNSUCCESSFUL
 当前没有与数据流关联的上下文。
STATUS_PENDING
 活动标注分类正在进行中。
其他状态代码
 出现了错误。

注解

如果 FwpsFlowRemoveContext0 函数返回STATUS_SUCCESS， 则 FwpsFlowRemoveContext0 会同步调用 flowDeleteFn 标注函数。 如果 FwpsFlowRemoveContext0 返回STATUS_PENDING， 则 FwpsFlowRemoveContext0 异步调用 flowDeleteFn ，因为正在进行活动标注分类。

要求

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

另请参阅

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsFlowAssociateContext0

classifyFn

flowDeleteFn