Поделиться через

структура 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

Будут возвращены только фильтры, тип действия которых содержит хотя бы один бит в 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**
 Перечисление фильтров, ссылающихся на драйверы выносок.
**Примечание** **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

Структуры API платформы фильтрации Windows