FWPM_CALLOUT0 结构 (fwpmtypes.h)

  • 项目

FWPM_CALLOUT0结构存储与标注关联的状态。

语法

typedef struct FWPM_CALLOUT0_ {
  GUID               calloutKey;
  FWPM_DISPLAY_DATA0 displayData;
  UINT32             flags;
  GUID               *providerKey;
  FWP_BYTE_BLOB      providerData;
  GUID               applicableLayer;
  UINT32             calloutId;
} FWPM_CALLOUT0;

成员

calloutKey

唯一标识会话。

如果在调用 FwpmCalloutAdd0 时将 GUID 初始化为零，则基本筛选引擎 (BFE) 将生成一个。

displayData

包含与标注关联的可读注释 的FWPM_DISPLAY_DATA0 结构。 需要FWPM_DISPLAY_DATA0结构的名称成员。

flags

值 含义
FWPM_CALLOUT_FLAG_PERSISTENT
 标注在重新启动后是永久性的。 因此，启动时间和其他永久性筛选器可以引用它。
FWPM_CALLOUT_FLAG_USES_PROVIDER_CONTEXT
 标注需要访问调用标注的筛选器中存储的提供程序上下文。 如果设置了此标志，则提供程序上下文将从 [FWPM_FILTER0] (/windows/desktop/api/fwpmtypes/ns-fwpmtypes-fwpm_filter0) 结构复制到 FWPS_FILTER0 结构。 FWPS_FILTER0结构记录在 WDK 中。
FWPM_CALLOUT_FLAG_REGISTERED
 标注当前已在内核中注册。 添加新标注时，不得设置此标志。 它仅用于查询现有标注的状态。

providerKey

唯一标识与标注关联的提供程序。 如果该成员为非 NULL，则仅返回与指定提供程序关联的对象。

providerData

一个FWP_BYTE_BLOB结构，其中包含特定于提供程序的可选数据，该数据允许提供程序与 对象一起存储其他上下文信息。

applicableLayer

指定可以使用标注的层。 只有此层中的筛选器才能调用标注。 有关详细信息，请参阅 筛选层标识符。

calloutId

标识标注的 LUID。 这是存储在调用标注的筛选器FWPS_ACTION0结构中的 calloutId。 WDK 中记录了FWPS_ACTION0结构。

注解

此结构的前六个成员包含添加对象时提供的数据。

最后一个成员 calloutId 提供获取/枚举对象时返回的其他信息。

FWPM_CALLOUT0 是FWPM_CALLOUT的特定实现。 有关详细信息 ，请参阅 WFP Version-Independent 名称和面向 Windows 的特定版本 。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 fwpmtypes.h

另请参阅

Windows 筛选平台 API 结构