FWPM_PROVIDER_CONTEXT3 結構 (fwpmtypes.h)

儲存與提供者內容相關聯的狀態。 FWPM_PROVIDER_CONTEXT0FWPM_PROVIDER_CONTEXT1FWPM_PROVIDER_CONTEXT2 可供使用。

語法

typedef struct FWPM_PROVIDER_CONTEXT3_ {
  GUID                       providerContextKey;
  FWPM_DISPLAY_DATA0         displayData;
  UINT32                     flags;
  GUID                       *providerKey;
  FWP_BYTE_BLOB              providerData;
  FWPM_PROVIDER_CONTEXT_TYPE type;
  union {
    IPSEC_KEYING_POLICY1                     *keyingPolicy;
    IPSEC_TRANSPORT_POLICY2                  *ikeQmTransportPolicy;
    IPSEC_TUNNEL_POLICY3                     *ikeQmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY2                  *authipQmTransportPolicy;
    IPSEC_TUNNEL_POLICY3                     *authipQmTunnelPolicy;
    IKEEXT_POLICY2                           *ikeMmPolicy;
    IKEEXT_POLICY2                           *authIpMmPolicy;
    FWP_BYTE_BLOB                            *dataBuffer;
    FWPM_CLASSIFY_OPTIONS0                   *classifyOptions;
    IPSEC_TUNNEL_POLICY3                     *ikeV2QmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY2                  *ikeV2QmTransportPolicy;
    IKEEXT_POLICY2                           *ikeV2MmPolicy;
    IPSEC_DOSP_OPTIONS0                      *idpOptions;
    FWPM_NETWORK_CONNECTION_POLICY_SETTINGS0 *networkConnectionPolicy;
  };
  UINT64                     providerContextId;
} FWPM_PROVIDER_CONTEXT3;

成員

providerContextKey

類型: GUID

唯一識別提供者內容。 如果在 FwpmProviderContextAdd2 的呼叫中初始化 GUID,則基底篩選引擎 (BFE) 會產生一個。

displayData

類型: FWPM_DISPLAY_DATA0

允許以人類可讀的格式標註提供者內容。 需要 FWPM_DISPLAY_DATA0 結構。

flags

類型: UINT32

可能的值:

提供者內容旗標 意義
FWPM_PROVIDER_CONTEXT_FLAG_PERSISTENT 對像是持續性的,也就是說,它會在 BFE 停止/啟動之間存留。
FWPM_PROVIDER_CONTEXT_FLAG_DOWNLEVEL 保留供內部使用。

providerKey

類型: GUID*

管理此物件之原則提供者的 GUID。

providerData

類型: FWP_BYTE_BLOB

選擇性的提供者特定數據,可讓提供者使用 物件儲存其他內容資訊。

type

類型: FWPM_PROVIDER_CONTEXT_TYPE

提供者內容的型別。

keyingPolicy

類型: IPSEC_KEYING_POLICY1*

當類型為 FWPM_IPSEC_KEYING_CONTEXT時可用。

ikeQmTransportPolicy

類型: IPSEC_TRANSPORT_POLICY2*

當類型為 FWPM_IPSEC_IKE_QM_TRANSPORT_CONTEXT時可用。

ikeQmTunnelPolicy

類型: IPSEC_TUNNEL_POLICY2*

當類型為 FWPM_IPSEC_IKE_QM_TUNNEL_CONTEXT時可用。

authipQmTransportPolicy

類型: IPSEC_TRANSPORT_POLICY2*

[case () ][unique]

authipQmTunnelPolicy

類型: IPSEC_TUNNEL_POLICY2*

當類型為 FWPM_IPSEC_AUTHIP_QM_TRANSPORT_CONTEXT時可用。

ikeMmPolicy

類型: IKEEXT_POLICY2*

當類型為 FWPM_IPSEC_IKE_MM_CONTEXT時可用。

authIpMmPolicy

類型: IKEEXT_POLICY2*

當類型FWPM_IPSEC_AUTHIP_MM_CONTEXT時可用。

dataBuffer

類型: FWP_BYTE_BLOB*

當類型為 FWPM_GENERAL_CONTEXT時可用。

classifyOptions

類型: FWPM_CLASSIFY_OPTIONS0*

當類型為 FWPM_CLASSIFY_OPTIONS_CONTEXT時可用。

ikeV2QmTunnelPolicy

類型: IPSEC_TUNNEL_POLICY2*

當類型為 FWPM_IPSEC_IKEV2_QM_TUNNEL_CONTEXT時可用。

ikeV2QmTransportPolicy

類型: IPSEC_TRANSPORT_POLICY2*

當類型為 FWPM_IPSEC_IKEV2_QM_TRANSPORT_CONTEXT時可用。

ikeV2MmPolicy

類型: IKEEXT_POLICY2*

當類型為 FWPM_IPSEC_IKEV2_MM_CONTEXT時可用。

idpOptions

類型: IPSEC_DOSP_OPTIONS0*

當類型為 FWPM_IPSEC_DOSP_CONTEXT時可用。

networkConnectionPolicy

包含網路連線原則數目的 FWPM_NETWORK_CONNECTION_POLICY_SETTINGS0 結構的指標,以及格式化這些原則的清單。

providerContextId

類型: UINT64

識別內容的 LUID。 這是儲存在 FWPS_FILTER1 結構中以參考提供者內容之篩選的內容值。 FWPS_FILTER1 結構記載於 WDK 中。 這是取得/列舉物件時所傳回的其他資訊。

備註

聯集的前七個元素是新增物件時所提供的資訊。

規格需求

需求
標頭 fwpmtypes.h

另請參閱

FWPM_DISPLAY_DATA0

FWPM_PROVIDER_CONTEXT_TYPE

FWP_BYTE_BLOB

FwpmProviderContextAdd2

IKEEXT_POLICY2

IPSEC_DOSP_OPTIONS0

IPSEC_KEYING_POLICY0

IPSEC_TRANSPORT_POLICY2

IPSEC_TUNNEL_POLICY2

Windows 篩選平臺 API 結構