Función FwpsCalloutUnregisterById0 (fwpsk.h)

  • Artículo

La función FwpsCalloutUnregisterById0 anula el registro de una llamada del motor de filtro.

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

Sintaxis

NTSTATUS FwpsCalloutUnregisterById0(
  [in] const UINT32 calloutId
);

Parámetros

[in] calloutId

Identificador en tiempo de ejecución de la llamada que se está anulando el registro 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 FwpsCalloutRegister0 o FwpsCalloutRegister1 para registrar la llamada con el motor de filtros.

Valor devuelto

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

Código devuelto Descripción
STATUS_SUCCESS
 La llamada se anulación correctamente del registro del motor de filtro.
STATUS_DEVICE_BUSY
 La llamada procesa uno o varios flujos de datos que tienen un contexto pendiente asociado al flujo de datos. Un controlador de llamada debe llamar a la función FwpsFlowRemoveContext0 para cada uno de estos flujos de datos para quitar el contexto asociado. Una vez que el contexto se haya quitado correctamente de cada uno de estos flujos de datos, el controlador de llamada debe llamar de nuevo a la función FwpsCalloutUnregisterById0 para finalizar el registro de la llamada del motor de filtros.
STATUS_FWP_CALLOUT_NOT_FOUND
 No hay ninguna llamada registrada con el motor de filtros que coincida con el identificador en tiempo de ejecución especificado en el parámetro calloutId .
STATUS_FWP_IN_USE
 La llamada ya está en proceso de registro o anulación del registro en otro subproceso.
Otros códigos de estado
 Se produjo un error.

Comentarios

Un controlador de llamada llama a la función FwpsCalloutUnregisterById0 para anular el registro de una llamada del motor de filtro, mediante el identificador en tiempo de ejecución para identificar la llamada que se va a anular el registro. Esta función se realiza correctamente incluso si hay filtros en el motor de filtros que especifican la llamada para la acción del 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 después de que se haya anulado el registro de la llamada desde el motor de filtros.

No se puede descargar un controlador de llamada hasta que todas las llamadas que se registraron anteriormente con el motor de filtro se han anulado correctamente el registro.

Requisitos

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

Consulte también

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsCalloutUnregisterByKey0

FwpsFlowRemoveContext0

Tipos de llamadas