Compartir a través de

Función FwpmCalloutAdd0 (fwpmk.h)

  • Artículo

La función FwpmCalloutAdd0 agrega una llamada al motor de filtro.

Sintaxis

NTSTATUS FwpmCalloutAdd0(
  [in]            HANDLE               engineHandle,
  [in]            const FWPM_CALLOUT0  *callout,
  [in, optional]  PSECURITY_DESCRIPTOR sd,
  [out, optional] UINT32               *id
);

Parámetros

[in] engineHandle

Identificador de una sesión abierta en el motor de filtro. Un controlador de llamada llama a la función FwpmEngineOpen0 para abrir una sesión en el motor de filtro.

[in] callout

Puntero a una estructura FWPM_CALLOUT0 constante que contiene los datos necesarios para agregar la llamada al motor de filtro.

[in, optional] sd

Puntero a una estructura SECURITY_DESCRIPTOR constante que describe el descriptor de seguridad de la llamada que se va a agregar al motor de filtro. Este parámetro es opcional y se puede NULL.

[out, optional] id

Puntero a una variable con tipo UINT32 que recibe un identificador en tiempo de ejecución que identifica la llamada en el motor de filtro. Este es el mismo identificador que se devuelve cuando un controlador de llamada registra las funciones de llamada del controlador de llamada con el motor de filtro. El controlador de llamada pasa este identificador al fwpmCalloutDeleteById0 función al quitar la llamada del motor de filtro. Este parámetro es opcional y se puede NULL.

Valor devuelto

La función FwpmCalloutAdd0 devuelve uno de los siguientes códigos NTSTATUS:

Código devuelto Descripción
STATUS_SUCCESS La llamada se agregó correctamente al motor de filtro.
STATUS_FWP_ALREADY_EXISTS No se pudo agregar la llamada al motor de filtro. Ya existe una llamada en el motor de filtro con un identificador idéntico al GUID especificado en el elemento calloutKey miembro de la estructura de FWPM_CALLOUT0 a la que apunta el parámetro llamada.
otros códigos NTSTATUS Error.

Observaciones

Un controlador de llamada llama a la función FwpmCalloutAdd0 para agregar una llamada al motor de filtro.

Normalmente, los controladores de llamada no agregan sus llamadas al motor de filtro. En la mayoría de las situaciones, esto se controla mediante una aplicación de administración de plataformas de filtrado de Windows en modo de usuario.

Una llamada y filtros que especifican la llamada para la acción del filtro se puede agregar al motor de filtros antes de que un controlador de llamada registre la llamada con el motor de filtro. En esta situación, los filtros con un tipo de acción de FWP_ACTION_CALLOUT_TERMINATING o FWP_ACTION_CALLOUT_UNKNOWN se tratan como FWP_ACTION_BLOCK y los filtros con un tipo de acción de FWP_ACTION_CALLOUT_INSPECTION se omiten hasta que la llamada se registra en el motor de filtro.

fwpmCalloutAdd0 es una versión específica de FwpmCalloutAdd. Consulta nombres Version-Independent DEL PMA y destinatarios de versiones específicas de Windows para obtener más información.

Requisitos

Requisito Valor
cliente mínimo admitido Disponible a partir de Windows Vista.
de la plataforma de destino de Universal
encabezado de fwpmk.h (incluya Fwpmk.h)
biblioteca de Fwpkclnt.lib
irQL PASSIVE_LEVEL

Consulte también