Função FwpsFlowRemoveContext0 (fwpsk.h)

  • Artigo

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

ObservaçãoFwpsFlowRemoveContext0 é uma versão específica do FwpsFlowRemoveContext. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas 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 FWPS_METADATA_FIELD_FLOW_HANDLE valor de metadados que foi passado para a função de texto explicativo classifyFn do driver 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 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 as funções FwpsCalloutRegister0 ou FwpsCalloutRegister1 para registrar o texto explicativo com o mecanismo de filtro.

Retornar valor

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
 No momento, não há contexto 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.

Comentários

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

Requisitos

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

Confira também

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsFlowAssociateContext0

classifyFn

flowDeleteFn