Compartir a través de

Función FwpmCalloutDeleteById0 (fwpmk.h)

  • Artículo

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

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

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

Observaciones

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

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