Función FwpsFlowRemoveContext0 (fwpsk.h)

  • Artículo

La función FwpsFlowRemoveContext0 quita un contexto asociado previamente de un flujo de datos.

NotaFwpsFlowRemoveContext0 es una versión específica de FwpsFlowRemoveContext. Para obtener más información, consulte NOMBRES de PMA Version-Independent y versiones específicas de destino de Windows .
 

Sintaxis

NTSTATUS FwpsFlowRemoveContext0(
  [in] UINT64 flowId,
  [in] UINT16 layerId,
  [in] UINT32 calloutId
);

Parámetros

[in] flowId

Identificador en tiempo de ejecución que especifica el flujo de datos del que se va a quitar el contexto. El identificador en tiempo de ejecución de un flujo de datos se proporciona a un controlador de llamada a través del valor de metadatos de FWPS_METADATA_FIELD_FLOW_HANDLE que se pasó a la función de llamada classifyFn del controlador de llamada.

[in] layerId

Identificador en tiempo de ejecución de la capa de filtrado desde la que se va a quitar el contexto. Para obtener más información, consulte Identificadores de capa de filtrado en tiempo de ejecución. Un controlador de llamada debe especificar el mismo identificador que especificó cuando llamó a la función FwpsFlowAssociateContext0 para asociar el contexto con el flujo de datos.

[in] calloutId

Identificador en tiempo de ejecución de la llamada en el motor de filtro. Este identificador se devolvió cuando el controlador de llamada llamó a las funciones FwpsCalloutRegister0 o FwpsCalloutRegister1 para registrar la llamada con el motor de filtro.

Valor devuelto

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

Código devuelto Descripción
STATUS_SUCCESS
 El contexto se quitó correctamente del flujo de datos.
STATUS_UNSUCCESSFUL
 Actualmente no hay ningún contexto asociado al flujo de datos.
STATUS_PENDING
 Hay una clasificación de llamada activa en curso.
Otros códigos de estado
 Se produjo un error.

Comentarios

Si la función FwpsFlowRemoveContext0 devuelve STATUS_SUCCESS, FwpsFlowRemoveContext0 llama a la función de llamada flowDeleteFn de forma sincrónica. Si FwpsFlowRemoveContext0 devuelve STATUS_PENDING, FwpsFlowRemoveContext0 llama a flowDeleteFn de forma asincrónica porque hay una clasificación de llamada activa en curso.

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 <= DISPATCH_LEVEL

Consulte también

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsFlowAssociateContext0

classifyFn

flowDeleteFn