Función FwpsCalloutUnregisterByKey0 (fwpsk.h)

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

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

 

Sintaxis

NTSTATUS FwpsCalloutUnregisterByKey0(
  [in] const GUID *calloutKey
);

Parámetros

[in] calloutKey

Puntero a un GUID que identifica de forma única la llamada que se está anulando el registro del motor de filtros. Debe ser un puntero al mismo GUID que se especificó cuando el controlador de llamada llamó a la FwpsCalloutRegister0 o funciones de FwpsCalloutRegister1 para registrar la llamada con el motor de filtro.

Valor devuelto

La función FwpsCalloutUnregisterByKey0 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 FwpsCalloutUnregisterByKey0 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 GUID especificado en el parámetro calloutKey .
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 FwpsCalloutUnregisterByKey0 para anular el registro de una llamada del motor de filtro mediante la clave GUID 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

fwpsCalloutUnregisterById0

fwpsFlowRemoveContext0

tipos de llamadas de