Share via

estructura FWPM_FILTER_ENUM_TEMPLATE0 (fwpmtypes.h)

  • Artículo

La estructura FWPM_FILTER_ENUM_TEMPLATE0 se usa para enumerar filtros.

Sintaxis

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;

Miembros

providerKey

Identifica de forma única el proveedor asociado a este filtro.

layerKey

Capa cuyos campos se van a enumerar.

enumType

Valor FWP_FILTER_ENUM_TYPE que determina cómo se interpretan las condiciones de filtro.

flags

Valor Significado
FWP_FILTER_ENUM_FLAG_BEST_TERMINATING_MATCH
 Solo devuelve el filtro de terminación con el peso más alto.
FWP_FILTER_ENUM_FLAG_SORTED
 Devuelve todos los filtros coincidentes ordenados por peso (más alto a menor).
FWP_FILTER_ENUM_FLAG_BOOTTIME_ONLY
 Devuelve solo filtros de tiempo de arranque.
FWP_FILTER_ENUM_FLAG_INCLUDE_BOOTTIME
 Incluir filtros en tiempo de arranque; se omite si se establece la marca FWP_FILTER_ENUM_FLAG_BOOTTIME_ONLY .
FWP_FILTER_ENUM_FLAG_INCLUDE_DISABLED
 Incluir filtros deshabilitados; se omite si se establece la marca FWP_FILTER_ENUM_FLAG_BOOTTIME_ONLY .
FWP_FILTER_ENUM_VALID_FLAGS
 Combinación de FWP_FILTER_ENUM_FLAG_BEST_TERMINATING_MATCH y FWP_FILTER_ENUM_FLAG_SORTED.

providerContextTemplate

Estructura FWPM_PROVIDER_CONTEXT_ENUM_TEMPLATE0 que se usa para limitar el número de filtros enumerados. Si no es NULL, solo enumera los filtros cuyo contexto de proveedor coincide con la plantilla.

numFilterConditions

Número de condiciones de filtro. Si es cero, todos los filtros coinciden.

filterCondition

Matriz de estructuras de FWPM_FILTER_CONDITION0 que contienen condiciones de filtro distintas (las condiciones de filtro duplicadas generarán un error).

actionMask

Solo se devolverán filtros cuyo tipo de acción contenga al menos uno de los bits de actionMask . Es posible que el uso de las constantes FWP_ACTION_ directamente no funcione según lo previsto, ya que contienen varios bits. Algunos ejemplos comunes se encuentran en la tabla siguiente (^ representa el operador XOR lógico).

Valor Significado
FWP_ACTION_BLOCK ^ FWP_ACTION_FLAG_TERMINATING
 Enumerar filtros que tienen una acción **FWP_ACTION_BLOCK**.
FWP_ACTION_PERMIT ^ FWP_ACTION_FLAG_TERMINATING
 Enumerar filtros que tienen una acción **FWP_ACTION_PERMIT**.
**FWP_ACTION_FLAG_CALLOUT**
 Enumerar filtros que hacen referencia a controladores de llamada.
**Note** **calloutKey** no debe ser **NULL**.
 
0xffffffff
 Omita el tipo de acción del filtro al enumerar.

calloutKey

Identifica de forma única la llamada.

Comentarios

FWPM_FILTER_ENUM_TEMPLATE0 es una implementación específica de FWPM_FILTER_ENUM_TEMPLATE. Para obtener más información, vea NOMBRES DE Version-Independent DE PMA y versiones específicas de Windows dirigidas a destinatarios.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado fwpmtypes.h

Consulte también

FWPM_FILTER_CONDITION0

FWPM_PROVIDER_CONTEXT_ENUM_TEMPLATE0

FWP_FILTER_ENUM_TYPE

Estructuras de API de plataforma de filtrado de Windows