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
次の値の組み合わせ。
providerKey
このフィルターを管理するポリシー プロバイダーのオプションの GUID。 定義済みのポリシー プロバイダーの一覧については、「 組み込みのプロバイダー識別子 」を参照してください。
providerData
オブジェクトに追加のコンテキスト情報を格納するためにプロバイダーによって使用されるオプションのプロバイダー固有のデータを含む FWP_BYTE_BLOB 構造体。
layerKey
フィルターが存在するレイヤーの GUID。 使用可能な値の一覧については、「 レイヤー識別子のフィルター処理 」を参照してください。
subLayerKey
フィルターが存在するサブレイヤーの GUID。 組み込みのサブレイヤーの一覧については、「 Sub-Layer 識別子のフィルター処理 」を参照してください。
これがIID_NULLに設定されている場合、フィルターは既定のサブレイヤーに追加されます。
weight
フィルター の 重みを指定するFWP_VALUE0構造体。 重みはフィルターの優先度を示します。数値の大きい重みの方が優先順位が高くなります (重みが低いフィルターの前に評価されます)。
weight に使用できる型の値は次のとおりです。
**weight** 型 | 意味 |
---|---|
|
BFE は、指定された値をフィルターの重みとして使用します。 |
|
BFE は、指定された値を重み範囲インデックスとして使用し、その範囲内のフィルターの重みを計算します。 詳細については、「 重みの割り当てをフィルター処理 する」を参照してください。 |
|
BFE は、フィルター条件に基づいて自動的に重みを割り当てます。 |
フィルターの重みの計算に使用できる組み込み定数については、「フィルター重み識別子」を参照してください。
numFilterConditions
フィルター条件の数。
filterCondition
すべてのフィルター条件を含む FWPM_FILTER_CONDITION0 構造体の配列。 アクションを実行するには、すべて true である必要があります。 つまり、条件は AND 演算子を使用して評価されます。 条件が指定されていない場合、アクションは常に実行されます。
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 |