Compartir a través de

Función FwpmCalloutDeleteByKey0 (fwpmk.h)

  • Artículo

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

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 "callout" 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 filtro. 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 filtro.

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 clave.
otros códigos NTSTATUS Error.

Observaciones

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 filtro. En la mayoría de las situaciones, esto se controla mediante un modo de usuario aplicación de administración de la plataforma de filtrado de Windows.

Una llamada se puede eliminar del motor de filtro solo si no hay ningún filtro en el motor de filtros que especifique la llamada para la acción del filtro.

fwpmCalloutDeleteByKey0 es una versión específica de FwpmCalloutDeleteByKey. 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