Función FwpsCalloutUnregisterById0 (fwpsk.h)

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

NotafwpsCalloutUnregisterById0 es una versión específica de FwpsCalloutUnregisterById. Consulta nombres Version-Independent DEL PMA y destinatarios de versiones específicas de Windows para obtener más información.

 

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

Valor devuelto

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

Código devuelto	Descripción
STATUS_SUCCESS	La llamada se ha anulado 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 ha quitado correctamente de cada uno de estos flujos de datos, el controlador de llamada debe llamar al FwpsCalloutUnregisterById0 función para terminar de anular el registro de la llamada del motor de filtro.
STATUS_FWP_CALLOUT_NOT_FOUND	No hay ninguna llamada registrada con el motor de filtro 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 registrarse o anular el registro en otro subproceso.
otros códigos de estado	Error.

Observaciones

Un controlador de llamada llama a la función FwpsCalloutUnregisterById0 para anular el registro de una llamada del motor de filtros, 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_BLOCKy 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	Valor
cliente mínimo admitido	Disponible a partir de Windows Vista.
de la plataforma de destino de	Universal
encabezado de	fwpsk.h (incluya Fwpsk.h)
biblioteca de	Fwpkclnt.lib
irQL	PASSIVE_LEVEL

Consulte también

fwpsCalloutRegister0

fwpsCalloutRegister1

fwpsCalloutUnregisterByKey0

fwpsFlowRemoveContext0

tipos de llamadas de