Compartir a través de

estructura FWPM_CALLOUT0 (fwpmtypes.h)

  • Artículo

La estructura FWPM_CALLOUT0 almacena el estado asociado a una llamada.

Sintaxis

typedef struct FWPM_CALLOUT0_ {
  GUID               calloutKey;
  FWPM_DISPLAY_DATA0 displayData;
  UINT32             flags;
  GUID               *providerKey;
  FWP_BYTE_BLOB      providerData;
  GUID               applicableLayer;
  UINT32             calloutId;
} FWPM_CALLOUT0;

Miembros

calloutKey

Identifica de forma única la sesión.

Si el GUID se inicializa en cero en la llamada a FwpmCalloutAdd0, el motor de filtrado base (BFE) generará uno.

displayData

Estructura FWPM_DISPLAY_DATA0 que contiene anotaciones legibles humanas asociadas a la llamada. Se requiere el miembro de nombre de la estructura FWPM_DISPLAY_DATA0 .

flags

Valor Significado
FWPM_CALLOUT_FLAG_PERSISTENT
 La llamada es persistente en los reinicios. Como resultado, se puede hacer referencia al mismo tiempo de arranque y a otros filtros persistentes.
FWPM_CALLOUT_FLAG_USES_PROVIDER_CONTEXT
 La llamada necesita acceso al contexto del proveedor almacenado en el filtro invocando la llamada. Si se establece esta marca, el contexto del proveedor se copiará de la estructura [FWPM_FILTER0](/windows/desktop/api/fwpmtypes/ns-fwpmtypes-fwpm_filter0) a la estructura de FWPS_FILTER0 . La estructura FWPS_FILTER0 se documenta en el WDK.
FWPM_CALLOUT_FLAG_REGISTERED
 La llamada está registrada actualmente en el kernel. Esta marca no debe establecerse al agregar nuevas llamadas. Solo se usa para consultar el estado de las llamadas existentes.

providerKey

Identifica de forma única el proveedor asociado a la llamada. Si el miembro no es NULL, solo se devolverán los objetos asociados al proveedor especificado.

providerData

Estructura FWP_BYTE_BLOB que contiene datos opcionales específicos del proveedor que permiten a los proveedores almacenar información de contexto adicional con el objeto .

applicableLayer

Especifica la capa en la que se puede usar la llamada. Solo los filtros de esta capa pueden invocar la llamada. Para obtener más información, consulte Filtrado de identificadores de capa.

calloutId

LUID que identifica la llamada. Este es el calloutId almacenado en la estructura de FWPS_ACTION0 para los filtros que invocan una llamada. La estructura FWPS_ACTION0 se documenta en el WDK.

Comentarios

Los seis primeros miembros de esta estructura contienen datos proporcionados al agregar objetos.

El último miembro, calloutId, proporciona información adicional devuelta al obtener o enumerar objetos.

FWPM_CALLOUT0 es una implementación específica de FWPM_CALLOUT. Para obtener más información, consulte NOMBRES de PMA Version-Independent y versiones específicas de destino de Windows .

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

Estructuras de api de plataforma de filtrado de Windows