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*

type がFWPM_IPSEC_IKE_QM_TUNNEL_CONTEXTされている場合に使用できます。

authipQmTransportPolicy

種類: IPSEC_TRANSPORT_POLICY2*

[case()][unique]

authipQmTunnelPolicy

種類: IPSEC_TUNNEL_POLICY2*

type がFWPM_IPSEC_AUTHIP_QM_TRANSPORT_CONTEXTされている場合に使用できます。

ikeMmPolicy

種類: IKEEXT_POLICY2*

type がFWPM_IPSEC_IKE_MM_CONTEXTされている場合に使用できます。

authIpMmPolicy

種類: IKEEXT_POLICY2*

型がFWPM_IPSEC_AUTHIP_MM_CONTEXTされている場合に使用できます。

dataBuffer

種類: FWP_BYTE_BLOB*

type がFWPM_GENERAL_CONTEXTされている場合に使用できます。

classifyOptions

種類: FWPM_CLASSIFY_OPTIONS0*

type がFWPM_CLASSIFY_OPTIONS_CONTEXTされている場合に使用できます。

ikeV2QmTunnelPolicy

種類: IPSEC_TUNNEL_POLICY2*

type がFWPM_IPSEC_IKEV2_QM_TUNNEL_CONTEXTされている場合に使用できます。

ikeV2QmTransportPolicy

種類: IPSEC_TRANSPORT_POLICY2*

型がFWPM_IPSEC_IKEV2_QM_TRANSPORT_CONTEXTされている場合に使用できます。

ikeV2MmPolicy

種類: IKEEXT_POLICY2*

type がFWPM_IPSEC_IKEV2_MM_CONTEXT場合に使用できます。

idpOptions

種類: IPSEC_DOSP_OPTIONS0*

型がFWPM_IPSEC_DOSP_CONTEXT場合に使用できます。

providerContextId

種類: UINT64

コンテキストを識別する LUID。これは、プロバイダーコンテキストを参照するフィルターの FWPS_FILTER1 構造体に格納されているコンテキスト値です。 FWPS_FILTER1構造は WDK に記載されています。

注釈

共用体の最初の 7 つの要素は、オブジェクトを追加するときに提供される情報です。

最後の要素は、オブジェクトの取得/列挙時に返される追加情報です。

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップアプリのみ]
Header	fwpmtypes.h