FwpsNetBufferListRetrieveContext0-Funktion (fwpsk.h)

Artikel
02/07/2025

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

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

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 Für den Popuptreiber interessantes Paket angibt. Wenn removeContext- festgelegt ist, hat die zurückgegebene Netzwerkpufferliste den Kontext entfernt.

[in] contextTag

Ein lokal eindeutiger Bezeichner, der durch Aufrufen der FwpsNetBufferListGetTagForContext0 Funktion. Dies ist das Kontexttag, das im ersten Aufruf von FwpsNetBufferListAssociateContext0verwendet wird.

[in] removeContext

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

[in] flags

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

[out] context

Der dem Paket vom Popuptreiber im ersten Aufruf von FwpsNetBufferListAssociateContext0zugewiesene Kontext.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Zuordnung war erfolgreich.
Andere Statuscodes	Fehler.

Bemerkungen

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

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar ab Windows 7.
Zielplattform-	Universal
Header-	fwpsk.h (include Fwpsk.h)
Library	Fwpkclnt.lib
IRQL-	<= DISPATCH_LEVEL

Siehe auch

FwpsNetBufferListAssociateContext0 FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0

NET_BUFFER_LIST

Freigeben über