FWPM_PROVIDER_CONTEXT2結構 (fwpmtypes.h)

發行項
02/26/2024

FWPM_PROVIDER_CONTEXT2結構會儲存與提供者內容相關聯的狀態。 FWPM_PROVIDER_CONTEXT0可供使用。

語法

typedef struct FWPM_PROVIDER_CONTEXT2_ {
  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_POLICY2    *ikeQmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY2 *authipQmTransportPolicy;
    IPSEC_TUNNEL_POLICY2    *authipQmTunnelPolicy;
    IKEEXT_POLICY2          *ikeMmPolicy;
    IKEEXT_POLICY2          *authIpMmPolicy;
    FWP_BYTE_BLOB           *dataBuffer;
    FWPM_CLASSIFY_OPTIONS0  *classifyOptions;
    IPSEC_TUNNEL_POLICY2    *ikeV2QmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY2 *ikeV2QmTransportPolicy;
    IKEEXT_POLICY2          *ikeV2MmPolicy;
    IPSEC_DOSP_OPTIONS0     *idpOptions;
  };
  UINT64                     providerContextId;
} FWPM_PROVIDER_CONTEXT2;

成員

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時可用。

providerContextId

類型： UINT64

識別內容的 LUID。這是儲存在參考提供者內容 之篩選FWPS_FILTER1 結構中的內容值。 FWPS_FILTER1結構記載於 WDK 中。

備註

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

最後一個專案是取得/列舉物件時傳回的其他資訊。

規格需求

需求	值
最低支援的用戶端	Windows 8 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2012 [僅限傳統型應用程式]
標頭	fwpmtypes.h