Função FwpsNetBufferListRetrieveContext0 (fwpsk.h)

Artigo
02/07/2025

A função FwpsNetBufferListRetrieveContext0 recupera o contexto associado a uma lista de buffers de rede marcada em outra camada.

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

Sintaxe

NTSTATUS FwpsNetBufferListRetrieveContext0(
  [in, out] NET_BUFFER_LIST *netBufferList,
  [in]      UINT64          contextTag,
  [in]      BOOLEAN         removeContext,
  [in]      UINT32          flags,
  [out]     UINT64          *context
);

Parâmetros

[in, out] netBufferList

Uma lista de buffers de rede que indica um ou mais pacotes de interesse para o driver de texto explicativo. Se removeContext estiver definida, a lista de buffers de rede retornada terá o contexto removido.

[in] contextTag

Um identificador local exclusivo obtido chamando o função de FwpsNetBufferListGetTagForContext0. Essa é a marca de contexto usada na chamada inicial para FwpsNetBufferListAssociateContext0.

[in] removeContext

Se definido, FwpsNetBufferListRetrieveContext0 removerá a associação de contexto além de recuperar o contexto.

[in] flags

Esse parâmetro é reservado para uso futuro e é definido como zero.

[out] context

O contexto atribuído ao pacote pelo driver de texto explicativo na chamada inicial para FwpsNetBufferListAssociateContext0.

Valor de retorno

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

Código de retorno	Descrição
STATUS_SUCCESS	A associação foi bem-sucedida.
Outros códigos de status	Ocorreu um erro.

Observações

A função FwpsNetBufferListRetrieveContext0 recupera uma lista de buffers de rede marcada em outra camada.

Você também pode usar essa função para remover a associação de contexto definindo o parâmetro removeContext.

Requisitos

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

Consulte também

FwpsNetBufferListAssociateContext0 FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0

NET_BUFFER_LIST

Partilhar via