FwpsNetBufferListRetrieveContext0-Funktion (fwpsk.h)

Artikel
02/26/2024

Die Funktion FwpsNetBufferListRetrieveContext0 ruft den Kontext ab, der einer Netzwerkpufferliste zugeordnet ist, die auf einer anderen Ebene markiert wurde.

HinweisFwpsNetBufferListRetrieveContext0 ist eine bestimmte Version von FwpsNetBufferListRetrieveContext. Weitere Informationen finden Sie unter WFP Version-Independent Namen und Zielgruppenspezifische Windows-Versionen .

Syntax

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

Parameter

[in, out] netBufferList

Eine Netzwerkpufferliste, die mindestens ein Paket angibt, das für den Legendentreiber von Interesse ist. Wenn removeContext festgelegt ist, wird der Kontext für die zurückgegebene Netzwerkpufferliste entfernt.

[in] contextTag

Ein lokal eindeutiger Bezeichner, der durch Aufrufen des FwpsNetBufferListGetTagForContext0-Funktion . Dies ist das Kontexttag, das beim ersten Aufruf von FwpsNetBufferListAssociateContext0 verwendet wird.

[in] removeContext

Wenn festgelegt, entfernt FwpsNetBufferListRetrieveContext0 zusätzlich zum Abrufen des Kontexts die Kontextzuordnung.

[in] flags

Dieser Parameter ist für die zukünftige Verwendung reserviert und auf Null festgelegt.

[out] context

Der Kontext, der dem Paket vom Legendentreiber beim ersten Aufruf von FwpsNetBufferListAssociateContext0 zugewiesen wurde.

Rückgabewert

Die Funktion FwpsNetBufferListRetrieveContext0 gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Zuordnung war erfolgreich.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

Die Funktion FwpsNetBufferListRetrieveContext0 ruft eine Netzwerkpufferliste ab, die auf einer anderen Ebene markiert wurde.

Sie können diese Funktion auch verwenden, um die Kontextzuordnung zu entfernen, indem Sie den removeContext-Parameter festlegen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 7.
Zielplattform	Universell
Header	fwpsk.h (include fwpsk.h)
Bibliothek	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL

Weitere Informationen

FwpsNetBufferListAssociateContext0 FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0

NET_BUFFER_LIST

Freigeben über