FwpsNetBufferListRetrieveContext0-Funktion (fwpsk.h)

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

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.

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

Weitere Informationen

NET_BUFFER_LIST