Fonction FwpsNetBufferListRetrieveContext0 (fwpsk.h)

Article
02/26/2024

La fonction FwpsNetBufferListRetrieveContext0 récupère le contexte associé à une liste de mémoires tampons réseau qui a été marquée dans une autre couche.

RemarqueFwpsNetBufferListRetrieveContext0 est une version spécifique de FwpsNetBufferListRetrieveContext. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows .

Syntaxe

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

Paramètres

[in, out] netBufferList

Liste de mémoires tampons réseau qui indique un ou plusieurs paquets d’intérêt pour le pilote de légende. Si removeContext est défini, le contexte est supprimé dans la liste de mémoires tampons réseau retournée.

[in] contextTag

Identificateur unique localement obtenu en appelant le Fonction FwpsNetBufferListGetTagForContext0 . Il s’agit de la balise de contexte utilisée dans l’appel initial à FwpsNetBufferListAssociateContext0.

[in] removeContext

Si cette valeur est définie, FwpsNetBufferListRetrieveContext0 supprime l’association de contexte en plus de récupérer le contexte.

[in] flags

Ce paramètre est réservé pour une utilisation ultérieure et est défini sur zéro.

[out] context

Contexte affecté au paquet par le pilote de légende dans l’appel initial à FwpsNetBufferListAssociateContext0.

Valeur retournée

La fonction FwpsNetBufferListRetrieveContext0 retourne l’un des codes NTSTATUS suivants.

Code de retour	Description
STATUS_SUCCESS	L’association a réussi.
Autres codes status	Une erreur est survenue.

Remarques

La fonction FwpsNetBufferListRetrieveContext0 récupère une liste de mémoires tampons réseau qui a été marquée dans une autre couche.

Vous pouvez également utiliser cette fonction pour supprimer l’association de contexte en définissant le paramètre removeContext .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 7.
Plateforme cible	Universal
En-tête	fwpsk.h (include Fwpsk.h)
Bibliothèque	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL

Voir aussi

FwpsNetBufferListAssociateContext0 FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0

NET_BUFFER_LIST

Partager via