FwpsFlowRemoveContext0-Funktion (fwpsk.h)

Artikel
05/04/2023

Die FwpsFlowRemoveContext0-Funktion entfernt einen zuvor zugeordneten Kontext aus einem Datenfluss.

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

Syntax

NTSTATUS FwpsFlowRemoveContext0(
  [in] UINT64 flowId,
  [in] UINT16 layerId,
  [in] UINT32 calloutId
);

Parameter

[in] flowId

Ein Laufzeitbezeichner, der den Datenfluss angibt, aus dem der Kontext entfernt werden soll. Der Laufzeitbezeichner für einen Datenfluss wird einem Legendentreiber über den FWPS_METADATA_FIELD_FLOW_HANDLE Metadatenwert bereitgestellt, der an die Legendenfunktion klassifizierenFn des Legendentreibers übergeben wurde.

[in] layerId

Der Laufzeitbezeichner für die Filterebene, aus der der Kontext entfernt wird. Weitere Informationen finden Sie unter Laufzeitfilterung von Ebenenbezeichnern. Ein Legendentreiber sollte denselben Bezeichner angeben, den er beim Aufrufen der Funktion FwpsFlowAssociateContext0 angegeben hat, um den Kontext dem Datenfluss zuzuordnen.

[in] calloutId

Der Laufzeitbezeichner für die Beschriftung in der Filter-Engine. Dieser Bezeichner wurde zurückgegeben, wenn der Legendentreiber entweder die Funktionen FwpsCalloutRegister0 oder FwpsCalloutRegister1 aufgerufen hat, um die Legende bei der Filter-Engine zu registrieren.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Kontext wurde erfolgreich aus dem Datenfluss entfernt.
STATUS_UNSUCCESSFUL	Dem Datenfluss ist derzeit kein Kontext zugeordnet.
STATUS_PENDING	Eine aktive Legendenklassifizierung wird ausgeführt.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

Wenn die FwpsFlowRemoveContext0-Funktion STATUS_SUCCESS zurückgibt, ruft FwpsFlowRemoveContext0 die callout-Funktion flowDeleteFn synchron auf. Wenn FwpsFlowRemoveContext0 STATUS_PENDING zurückgibt, ruft FwpsFlowRemoveContext0flowDeleteFn asynchron auf, da eine aktive Legendenklassifizierung ausgeführt wird.

Anforderungen

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