FWPM_PROVIDER_CONTEXT0 结构 (fwpmtypes.h)

FWPM_PROVIDER_CONTEXT0 结构存储与提供程序上下文关联的状态。 FWPM_PROVIDER_CONTEXT2 可用。

语法

typedef struct FWPM_PROVIDER_CONTEXT0_ {
  GUID                       providerContextKey;
  FWPM_DISPLAY_DATA0         displayData;
  UINT32                     flags;
  GUID                       *providerKey;
  FWP_BYTE_BLOB              providerData;
  FWPM_PROVIDER_CONTEXT_TYPE type;
  union {
    IPSEC_KEYING_POLICY0    *keyingPolicy;
    IPSEC_TRANSPORT_POLICY0 *ikeQmTransportPolicy;
    IPSEC_TUNNEL_POLICY0    *ikeQmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY0 *authipQmTransportPolicy;
    IPSEC_TUNNEL_POLICY0    *authipQmTunnelPolicy;
    IKEEXT_POLICY0          *ikeMmPolicy;
    IKEEXT_POLICY0          *authIpMmPolicy;
    FWP_BYTE_BLOB           *dataBuffer;
    FWPM_CLASSIFY_OPTIONS0  *classifyOptions;
  };
  UINT64                     providerContextId;
} FWPM_PROVIDER_CONTEXT0;

成员

providerContextKey

唯一标识提供程序上下文。 如果在调用 FwpmProviderContextAdd0 时 GUID 为零初始化,则基本筛选引擎 (BFE) 将生成一个。

displayData

允许以用户可读的形式批注提供程序上下文。 需要FWPM_DISPLAY_DATA0结构。

flags

可能的值:

提供程序上下文标志 含义
FWPM_PROVIDER_CONTEXT_FLAG_PERSISTENT 对象是永久性的,也就是说,它在 BFE 停止/启动中幸存下来。

providerKey

管理此对象的策略提供程序的 GUID。

providerData

包含可选提供程序特定数据的 FWP_BYTE_BLOB 结构,该数据允许提供程序存储对象的其他上下文信息。

type

指定提供程序上下文类型的 FWPM_PROVIDER_CONTEXT_TYPE 值。

keyingPolicy

类型为 FWPM_IPSEC_KEYING_CONTEXT 时可用。

有关详细信息 ,请参阅IPSEC_KEYING_POLICY0

ikeQmTransportPolicy

类型为 FWPM_IPSEC_IKE_QM_TRANSPORT_CONTEXT 时可用。

有关详细信息 ,请参阅IPSEC_TRANSPORT_POLICY0

ikeQmTunnelPolicy

类型FWPM_IPSEC_IKE_QM_TUNNEL_CONTEXT 时可用。

有关详细信息 ,请参阅IPSEC_TUNNEL_POLICY0

authipQmTransportPolicy

类型为 FWPM_IPSEC_AUTHIP_QM_TRANSPORT_CONTEXT 时可用。

有关详细信息 ,请参阅IPSEC_TRANSPORT_POLICY0

authipQmTunnelPolicy

类型为 FWPM_IPSEC_AUTHIP_QM_TUNNEL_CONTEXT 时可用。

有关详细信息 ,请参阅IPSEC_TUNNEL_POLICY0

ikeMmPolicy

类型FWPM_IPSEC_IKE_MM_CONTEXT 时可用。

有关详细信息 ,请参阅IKEEXT_POLICY0

authIpMmPolicy

类型FWPM_IPSEC_AUTHIP_MM_CONTEXT 时可用。

有关详细信息 ,请参阅IKEEXT_POLICY0

dataBuffer

类型为 FWPM_GENERAL_CONTEXT 时可用。

有关详细信息 ,请参阅FWP_BYTE_BLOB

classifyOptions

类型为 FWPM_CLASSIFY_OPTIONS_CONTEXT 时可用。

有关详细信息 ,请参阅FWPM_CLASSIFY_OPTIONS0

providerContextId

标识上下文的 LUID。 这是存储在引用提供程序上下文的筛选器 的FWPS_FILTER0 结构中的上下文值。 WDK 中记录了FWPS_FILTER0结构。

备注

联合的前七个元素是在添加对象时提供的信息。

最后一个元素是在获取/枚举对象时返回的其他信息。

要求

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

请参阅

Windows 筛选平台 API 结构