Compartilhar via


Função FwpsNetBufferListRetrieveContext0 (fwpsk.h)

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

ObservaçãoFwpsNetBufferListRetrieveContext0 é uma versão específica de FwpsNetBufferListRetrieveContext. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas 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 definido, a lista de buffers de rede retornada terá o contexto removido.

[in] contextTag

Um identificador local exclusivo obtido chamando o Função 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.

Retornar valor

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.

Comentários

A função FwpsNetBufferListRetrieveContext0 recupera uma lista de buffers de rede que foi 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
Cliente mínimo com suporte Disponível a partir do Windows 7.
Plataforma de Destino Universal
Cabeçalho fwpsk.h (inclua Fwpsk.h)
Biblioteca Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

Confira também

FwpsNetBufferListAssociateContext0 FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0

NET_BUFFER_LIST