Función FwpmCalloutAdd0 (fwpmk.h)

  • Artículo

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

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

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 filtros.

[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 puede ser 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 a la función FwpmCalloutDeleteById0 al quitar la llamada del motor de filtro. Este parámetro es opcional y puede ser 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 miembro calloutKey de la estructura FWPM_CALLOUT0 a la que apunta el parámetro callout .
Otros códigos de estado
 Se produjo un error.

Comentarios

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 filtros. En la mayoría de las situaciones, esto se controla mediante una aplicación de administración de plataforma 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 filtros.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de Windows Vista.
Plataforma de destino Universal
Encabezado fwpmk.h (incluya Fwpmk.h)
Library Fwpkclnt.lib
IRQL PASSIVE_LEVEL

Consulte también

FWPM_CALLOUT0

FwpmCalloutDeleteById0

FwpmCalloutDeleteByKey0

FwpmEngineOpen0

Tipos de llamadas