FWPM_FILTER_ENUM_TEMPLATE0 構造体 (fwpmtypes.h)

FWPM_FILTER_ENUM_TEMPLATE0構造体は、フィルターの列挙に使用されます。

構文

typedef struct FWPM_FILTER_ENUM_TEMPLATE0_ {
  GUID                                 *providerKey;
  GUID                                 layerKey;
  FWP_FILTER_ENUM_TYPE                 enumType;
  UINT32                               flags;
  FWPM_PROVIDER_CONTEXT_ENUM_TEMPLATE0 *providerContextTemplate;
  UINT32                               numFilterConditions;
  FWPM_FILTER_CONDITION0               *filterCondition;
  UINT32                               actionMask;
  GUID                                 *calloutKey;
} FWPM_FILTER_ENUM_TEMPLATE0;

メンバー

providerKey

このフィルターに関連付けられているプロバイダーを一意に識別します。

layerKey

フィールドを列挙するレイヤー。

enumType

フィルター条件の解釈方法を決定する FWP_FILTER_ENUM_TYPE 値。

flags

値	意味
FWP_FILTER_ENUM_FLAG_BEST_TERMINATING_MATCH	最も高い重みを持つ終端フィルターのみを返します。
FWP_FILTER_ENUM_FLAG_SORTED	重みで並べ替えられた一致するすべてのフィルターを返します (最高から最低)。
FWP_FILTER_ENUM_FLAG_BOOTTIME_ONLY	ブート時フィルターのみを返します。
FWP_FILTER_ENUM_FLAG_INCLUDE_BOOTTIME	ブート時フィルターを含める。 FWP_FILTER_ENUM_FLAG_BOOTTIME_ONLY フラグが設定されている場合は無視されます。
FWP_FILTER_ENUM_FLAG_INCLUDE_DISABLED	無効なフィルターを含める。 FWP_FILTER_ENUM_FLAG_BOOTTIME_ONLY フラグが設定されている場合は無視されます。
FWP_FILTER_ENUM_VALID_FLAGS	FWP_FILTER_ENUM_FLAG_BEST_TERMINATING_MATCHとFWP_FILTER_ENUM_FLAG_SORTEDの組み合わせ。

providerContextTemplate

列挙されるフィルターの数を制限するために使用されるFWPM_PROVIDER_CONTEXT_ENUM_TEMPLATE0構造体。 NULL 以外の場合は、プロバイダー コンテキストがテンプレートと一致するフィルターのみを列挙します。

numFilterConditions

フィルター条件の数。 0 の場合、すべてのフィルターが一致します。

filterCondition

個別のフィルター条件を含む FWPM_FILTER_CONDITION0 構造体の配列 (重複したフィルター条件によってエラーが生成されます)。

actionMask

actionMask に少なくとも 1 つのビットが含まれるアクションの種類のフィルターのみが返されます。 FWP_ACTION_定数を直接使用すると、複数のビットが含まれるため、意図したとおりに動作しない場合があります。 一般的な例をいくつか次の表に示します (^ は論理 XOR 演算子を表します)。

値	意味
FWP_ACTION_BLOCK ^ FWP_ACTION_FLAG_TERMINATING	**FWP_ACTION_BLOCK** アクションを持つフィルターを列挙します。
FWP_ACTION_PERMIT ^ FWP_ACTION_FLAG_TERMINATING	**FWP_ACTION_PERMIT** アクションを持つフィルターを列挙します。
**FWP_ACTION_FLAG_CALLOUT**	吹き出しドライバーを参照するフィルターを列挙します。 **注** **calloutKey** を **NULL** にすることはできません。
0xFFFFFFFF	列挙時にフィルターのアクションの種類を無視します。

calloutKey

吹き出しを一意に識別します。

注釈

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

要件

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

こちらもご覧ください

FWPM_FILTER_CONDITION0

FWPM_PROVIDER_CONTEXT_ENUM_TEMPLATE0

FWP_FILTER_ENUM_TYPE

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