Função FwpsFlowRemoveContext0 (fwpsk.h)

Artigo
02/07/2025

A função FwpsFlowRemoveContext0 remove um contexto associado anteriormente de um fluxo de dados.

Observação FwpsFlowRemoveContext0 é uma versão específica do FwpsFlowRemoveContext. Consulte nomes de Version-Independent WFP e versões específicas de destino do Windows para obter mais informações.

Sintaxe

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

Parâmetros

[in] flowId

Um identificador de tempo de execução que especifica o fluxo de dados do qual remover o contexto. O identificador de tempo de execução de um fluxo de dados é fornecido a um driver de texto explicativo por meio do valor de metadados FWPS_METADATA_FIELD_FLOW_HANDLE que foi passado para o driver de texto explicativo classificarfn função de texto explicativo.

[in] layerId

O identificador de tempo de execução para a camada de filtragem da qual o contexto está sendo removido. Para obter mais informações, consulte identificadores de camada de filtragem em tempo de execução. Um driver de texto explicativo deve especificar o mesmo identificador especificado quando ele chamou a função FwpsFlowAssociateContext0 para associar o contexto ao fluxo de dados.

[in] calloutId

O identificador de tempo de execução para o texto explicativo no mecanismo de filtro. Esse identificador foi retornado quando o driver de texto explicativo chamou o FwpsCalloutRegister0 ou FwpsCalloutRegister1 funções para registrar o texto explicativo com o mecanismo de filtro.

Valor de retorno

A função FwpsFlowRemoveContext0 retorna um dos seguintes códigos NTSTATUS.

Código de retorno	Descrição
STATUS_SUCCESS	O contexto foi removido com êxito do fluxo de dados.
STATUS_UNSUCCESSFUL	Não há nenhum contexto atualmente associado ao fluxo de dados.
STATUS_PENDING	Uma classificação de texto explicativo ativo está em andamento.
Outros códigos de status	Ocorreu um erro.

Observações

Se a função FwpsFlowRemoveContext0 retornar STATUS_SUCCESS, FwpsFlowRemoveContext0 chamará o flowDeleteFn função de texto explicativo de forma síncrona. Se FwpsFlowRemoveContext0 retornar STATUS_PENDING, FwpsFlowRemoveContext0 chamadas flowDeleteFn de forma assíncrona porque uma classificação de texto explicativo ativo está em andamento.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows Vista.
da Plataforma de Destino	Universal
cabeçalho	fwpsk.h (inclua Fwpsk.h)
biblioteca	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL

Consulte também

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsFlowAssociateContext0

classifyFn

flowDeleteFn

Compartilhar via