次の方法で共有

FWPM_FILTER0 構造体 (fwpmtypes.h)

  • [アーティクル]

FWPM_FILTER0構造体には、フィルターに関連付けられている状態が格納されます。

構文

typedef struct FWPM_FILTER0_ {
  GUID                   filterKey;
  FWPM_DISPLAY_DATA0     displayData;
  UINT32                 flags;
  GUID                   *providerKey;
  FWP_BYTE_BLOB          providerData;
  GUID                   layerKey;
  GUID                   subLayerKey;
  FWP_VALUE0             weight;
  UINT32                 numFilterConditions;
  FWPM_FILTER_CONDITION0 *filterCondition;
  FWPM_ACTION0           action;
  union {
    UINT64 rawContext;
    GUID   providerContextKey;
  };
  GUID                   *reserved;
  UINT64                 filterId;
  FWP_VALUE0             effectiveWeight;
} FWPM_FILTER0;

メンバー

filterKey

セッションを一意に識別します。

FwpmFilterAdd0 の呼び出しで GUID が 0 に初期化されると、基本フィルター エンジン (BFE) によって生成されます。

displayData

フィルター に 関連付けられた人間が判読できる注釈を含むFWPM_DISPLAY_DATA0構造体。 FWPM_DISPLAY_DATA0構造体の name メンバーが必要です。

flags

次の値の組み合わせ。

フィルター フラグ 意味
**FWPM_FILTER_FLAG_NONE**
 既定値。
**FWPM_FILTER_FLAG_PERSISTENT**
 フィルターは永続的です。つまり、BFE の停止/開始間で存続します。
**注** このフラグは**FWPM_FILTER_FLAG_BOOTTIME** と一緒に設定することはできません。
 
**FWPM_FILTER_FLAG_BOOTTIME**
 BFE が開始される前でも、ブート時にフィルターが適用されます。
**注** このフラグは**FWPM_FILTER_FLAG_PERSISTENT** と一緒に設定することはできません。
 
**FWPM_FILTER_FLAG_HAS_PROVIDER_CONTEXT**
 フィルターはプロバイダー コンテキストを参照します。
**FWPM_FILTER_FLAG_CLEAR_ACTION_RIGHT**
 フィルター アクションを右にクリアします。
**FWPM_FILTER_FLAG_PERMIT_IF_CALLOUT_UNREGISTERED**
 吹き出しが登録されていない場合、フィルターは許可フィルターとして扱われます。
**注** このフラグは、**action** 型が **FWP_ACTION_CALLOUT_TERMINATING** または **FWP_ACTION_CALLOUT_UNKNOWN** の場合にのみ設定できます。
 
**FWPM_FILTER_FLAG_DISABLED**
 フィルターが無効になっています。 プロバイダーのフィルターは、プロバイダーに Windows サービス名が関連付けられていない場合、または関連付けられているサービスが自動開始に設定されていない場合に、BFE が起動すると無効になります。
**注** このフラグは、新しいフィルターを追加するときに設定できません。 フィルターを取得または列挙する場合にのみ、BFE から返すことができます。
 
**FWPM_FILTER_FLAG_INDEXED**
 フィルターのインデックスは、分類中の検索の高速化に役立ちます。
**注** Windows 8とWindows Server 2012でのみ使用できます。
 

providerKey

このフィルターを管理するポリシー プロバイダーのオプションの GUID。 定義済みのポリシー プロバイダーの一覧については、「 組み込みのプロバイダー識別子 」を参照してください。

providerData

オブジェクトに追加のコンテキスト情報を格納するためにプロバイダーによって使用されるオプションのプロバイダー固有のデータを含む FWP_BYTE_BLOB 構造体。

layerKey

フィルターが存在するレイヤーの GUID。 使用可能な値の一覧については、「 レイヤー識別子のフィルター処理 」を参照してください。

subLayerKey

フィルターが存在するサブレイヤーの GUID。 組み込みのサブレイヤーの一覧については、「 Sub-Layer 識別子のフィルター処理 」を参照してください。

これがIID_NULLに設定されている場合、フィルターは既定のサブレイヤーに追加されます。

weight

フィルター の 重みを指定するFWP_VALUE0構造体。 重みはフィルターの優先度を示します。数値の大きい重みの方が優先順位が高くなります (重みが低いフィルターの前に評価されます)。

weight に使用できる型の値は次のとおりです。

**weight** 型 意味
**FWP_UINT64**
 BFE は、指定された値をフィルターの重みとして使用します。
**FWP_UINT8**
0–15
 BFE は、指定された値を重み範囲インデックスとして使用し、その範囲内のフィルターの重みを計算します。 詳細については、「 重みの割り当てをフィルター処理 する」を参照してください。
**FWP_EMPTY**
 BFE は、フィルター条件に基づいて自動的に重みを割り当てます。

フィルターの重みの計算に使用できる組み込み定数については、「フィルター重み識別子」を参照してください。

numFilterConditions

フィルター条件の数。

filterCondition

すべてのフィルター条件を含む FWPM_FILTER_CONDITION0 構造体の配列。 アクションを実行するには、すべて true である必要があります。 つまり、条件は AND 演算子を使用して評価されます。 条件が指定されていない場合、アクションは常に実行されます。

**注** Windows 7 および Windows Server 2008 R2 では、同じ fieldKey を持つ連続する条件が OR 演算子を使用して評価されます。
 

action

すべてのフィルター条件が true の場合に実行するアクションを指定する FWPM_ACTION0 構造体。

rawContext

フィルターにプロバイダー コンテキスト情報がない場合、つまり フラグ にFWPM_FILTER_FLAG_HAS_PROVIDER_CONTEXTが含まれていない場合 に使用できます。 組み込み可能な値の一覧については、「 フィルター コンテキスト識別子 」を参照してください。

rawContext は、WDK に記載されている対応するFWPS_FILTER0構造体のコンテキスト メンバーに "そのまま" 配置されます。

providerContextKey

フィルターにプロバイダー コンテキスト情報がある場合、つまり フラグ に FWPM_FILTER_FLAG_HAS_PROVIDER_CONTEXTが含まれている場合に使用できます。 定義済みのポリシー プロバイダー コンテキストの一覧については、「 組み込みの プロバイダー コンテキスト識別子」を参照してください。

providerContextKey によって指定されたプロバイダー コンテキストの LUID は、WDK に記載されている対応するFWPS_FILTER0構造体のコンテキスト メンバーを入力するために使用されます。

reserved

システムで使用するために予約されています。

filterId

フィルターを識別する LUID。 これは、WDK に記載されている対応する FWPS_FILTER0 構造体の LUID でもあります。

effectiveWeight

WDK に記載されている FWPS_FILTER0 に割り当てられた重みを含む FWP_VALUE0構造体。

注釈

この構造体の最初の 10 個のメンバーには、オブジェクトを追加するときに提供される情報が含まれています。

最後のメンバー filterId と effectiveWeight は、オブジェクトの取得/列挙時に追加情報を提供します。

FWPM_FILTER0 は、FWPM_FILTERの特定の実装です。 詳細については、「 WFP Version-Independent 名と特定のバージョンの Windows を対象 とする」を参照してください。

要件

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

こちらもご覧ください

FWPM_ACTION0

FWPM_DISPLAY_DATA0

FWPM_FILTER_CONDITION0

FWP_VALUE0

重み付けの割り当てのフィルター処理

重み識別子をフィルター処理する

Windows フィルタリング プラットフォーム API の構造