FWPM_PROVIDER_CONTEXT1 結構 (fwpmtypes.h)

發行項
02/27/2024

FWPM_PROVIDER_CONTEXT1結構會儲存與提供者內容相關聯的狀態。 FWPM_PROVIDER_CONTEXT2 可供使用。針對 Windows Vista，FWPM_PROVIDER_CONTEXT0 可供使用。

語法

typedef struct FWPM_PROVIDER_CONTEXT1_ {
  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_POLICY1 *ikeQmTransportPolicy;
    IPSEC_TUNNEL_POLICY1    *ikeQmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY1 *authipQmTransportPolicy;
    IPSEC_TUNNEL_POLICY1    *authipQmTunnelPolicy;
    IKEEXT_POLICY1          *ikeMmPolicy;
    IKEEXT_POLICY1          *authIpMmPolicy;
    FWP_BYTE_BLOB           *dataBuffer;
    FWPM_CLASSIFY_OPTIONS0  *classifyOptions;
    IPSEC_TUNNEL_POLICY1    *ikeV2QmTunnelPolicy;
    IKEEXT_POLICY1          *ikeV2MmPolicy;
    IPSEC_DOSP_OPTIONS0     *idpOptions;
  };
  UINT64                     providerContextId;
} FWPM_PROVIDER_CONTEXT1;

成員

providerContextKey

唯一識別提供者內容。如果在 FwpmProviderContextAdd1 呼叫中初始化 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_POLICY1 。

ikeQmTunnelPolicy

當類型為 FWPM_IPSEC_IKE_QM_TUNNEL_CONTEXT時可用。

如需詳細資訊，請參閱IPSEC_TUNNEL_POLICY1 。

authipQmTransportPolicy

當類型為 FWPM_IPSEC_AUTHIP_QM_TRANSPORT_CONTEXT時可用。

如需詳細資訊，請參閱IPSEC_TRANSPORT_POLICY1 。

authipQmTunnelPolicy

當類型為 FWPM_IPSEC_AUTHIP_QM_TUNNEL_CONTEXT時可用。

如需詳細資訊，請參閱IPSEC_TUNNEL_POLICY1 。

ikeMmPolicy

當類型為 FWPM_IPSEC_IKE_MM_CONTEXT時可用。

如需詳細資訊，請參閱IKEEXT_POLICY1 。

authIpMmPolicy

當類型FWPM_IPSEC_AUTHIP_MM_CONTEXT時可用。

如需詳細資訊，請參閱IKEEXT_POLICY1 。

dataBuffer

當類型為 FWPM_GENERAL_CONTEXT時可用。

如需詳細資訊，請參閱FWP_BYTE_BLOB 。

classifyOptions

當類型為 FWPM_CLASSIFY_OPTIONS_CONTEXT時可用。

如需詳細資訊，請參閱FWPM_CLASSIFY_OPTIONS0 。

ikeV2QmTunnelPolicy

當類型為 FWPM_IPSEC_IKEV2_QM_TUNNEL_CONTEXT時可用。

如需詳細資訊，請參閱IPSEC_TUNNEL_POLICY1 。

ikeV2MmPolicy

當類型為 FWPM_IPSEC_IKEV2_MM_CONTEXT時可用。

如需詳細資訊，請參閱IKEEXT_POLICY1 。

idpOptions

當類型為 FWPM_IPSEC_DOSP_CONTEXT時可用。

如需詳細資訊，請參閱IPSEC_DOSP_OPTIONS0 。

providerContextId

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

備註

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

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

規格需求

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