Función FwpmCalloutDeleteById0 (fwpmk.h)

  • Artículo

La función FwpmCalloutDeleteById0 elimina una llamada del motor de filtro.

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

Sintaxis

NTSTATUS FwpmCalloutDeleteById0(
  [in] HANDLE engineHandle,
  [in] 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] id

Identificador en tiempo de ejecución de la llamada que se va a eliminar del motor de filtro. Debe ser el identificador en tiempo de ejecución que se devolvió cuando el controlador de llamada llamó a la función FwpmCalloutAdd0 para agregar la llamada al motor de filtros.

Valor devuelto

La función FwpmCalloutDeleteById0 devuelve uno de los siguientes códigos NTSTATUS.

Código devuelto Descripción
STATUS_SUCCESS
 La llamada se eliminó correctamente del motor de filtro.
STATUS_FWP_IN_USE
 Uno o varios filtros del motor de filtros especifican la llamada para la acción del filtro.
STATUS_FWP_CALLOUT_NOT_FOUND
 No hay ninguna llamada en el motor de filtro que coincida con el identificador en tiempo de ejecución especificado en el parámetro id .
Otros códigos de estado
 Se produjo un error.

Comentarios

Un controlador de llamada llama a la función FwpmCalloutDeleteById0 para eliminar una llamada del motor de filtro, mediante el identificador en tiempo de ejecución para identificar la llamada que se va a eliminar.

Normalmente, los controladores de llamada no eliminan sus llamadas del motor de filtros. 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 solo se puede eliminar del motor de filtros si no hay ningún filtro en el motor de filtros que especifique la llamada para la acción del filtro.

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

FwpmCalloutAdd0

FwpmCalloutDeleteByKey0

FwpmEngineOpen0