共用方式為

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

篩選條件的數目。 如果為零，則所有篩選條件都相符。

filterCondition

包含相異篩選條件 ( 重複篩選條件FWPM_FILTER_CONDITION0結構的陣列將會產生錯誤) 。

actionMask

只會傳回動作類型包含動作 掩碼 中至少一個位的篩選條件。 直接使用 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**
 列舉參考圖說文字驅動程序的篩選。
**Note** **calloutKey** 不得為 **NULL**。
 
0xFFFFFFFF
 列舉時忽略篩選條件的動作類型。

calloutKey

唯一識別圖說文字。

備註

FWPM_FILTER_ENUM_TEMPLATE0 是FWPM_FILTER_ENUM_TEMPLATE的特定實作。 如需詳細資訊 ，請參閱 Version-Independent 名稱和以特定 Windows 版本為目標 。

規格需求

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

另請參閱

FWPM_FILTER_CONDITION0

FWPM_PROVIDER_CONTEXT_ENUM_TEMPLATE0

FWP_FILTER_ENUM_TYPE

Windows 篩選平臺 API 結構