Función FwpmCalloutDeleteByKey0 (fwpmk.h)

  • Artículo

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

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

Sintaxis

NTSTATUS FwpmCalloutDeleteByKey0(
  [in] HANDLE     engineHandle,
  [in] const GUID *key
);

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] key

Puntero a un GUID que identifica de forma única la llamada que se va a eliminar del motor de filtros. Debe ser un puntero al mismo GUID que se especificó cuando el controlador de llamada llamó a la función FwpmCalloutAdd0 para agregar la llamada al motor de filtros.

Valor devuelto

La función FwpmCalloutDeleteByKey0 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 una llamada en el motor de filtro que coincida con el GUID especificado en el parámetro de clave .
Otros códigos de estado
 Se produjo un error.

Comentarios

Un controlador de llamada llama a la función FwpmCalloutDeleteByKey0 para eliminar una llamada del motor de filtro, mediante la clave GUID 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

FwpmCalloutDeleteById0

FwpmEngineOpen0