Función FwpsNetBufferListRetrieveContext0 (fwpsk.h)

La función FwpsNetBufferListRetrieveContext0 recupera el contexto asociado a una lista de búferes de red etiquetada en otra capa.

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

 

Sintaxis

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

Lista de búferes de red que indica uno o varios paquetes de interés para el controlador de llamada. Si se establece removeContext , la lista de búferes de red devuelta tendrá quitado el contexto.

[in] contextTag

Identificador único local obtenido mediante una llamada a Función FwpsNetBufferListGetTagForContext0 . Esta es la etiqueta de contexto usada en la llamada inicial a FwpsNetBufferListAssociateContext0.

[in] removeContext

Si se establece, FwpsNetBufferListRetrieveContext0 quitará la asociación de contexto además de recuperar el contexto.

[in] flags

Este parámetro está reservado para uso futuro y se establece en cero.

[out] context

Contexto asignado al paquete por el controlador de llamada en la llamada inicial a FwpsNetBufferListAssociateContext0.

Valor devuelto

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

Código devuelto	Descripción
STATUS_SUCCESS	La asociación tuvo éxito.
Otros códigos de estado	Se produjo un error.

Comentarios

La función FwpsNetBufferListRetrieveContext0 recupera una lista de búferes de red etiquetada en otra capa.

También puede usar esta función para quitar la asociación de contexto estableciendo el parámetro removeContext .

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 7.
Plataforma de destino	Universal
Encabezado	fwpsk.h (incluya Fwpsk.h)
Library	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL

Consulte también

FwpsNetBufferListAssociateContext0 FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0

NET_BUFFER_LIST