FwpsFlowRemoveContext0-Funktion (fwpsk.h)

Artikel
02/07/2025

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 zielspezifische Versionen von Windows.

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 klassifizierenFn Legendenfunktion des Popuptreibers übergeben wurde.

[in] layerId

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

[in] calloutId

Der Laufzeitbezeichner für die Legende im Filtermodul. Dieser Bezeichner wurde zurückgegeben, wenn der Legendentreiber entweder die FwpsCalloutRegister0- oder FwpsCalloutRegister1- Funktionen aufgerufen hat, um die Legende beim Filtermodul 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	Derzeit ist kein Kontext mit dem Datenfluss verknüpft.
STATUS_PENDING	Eine aktive Beschriftungsklassifizierung wird ausgeführt.
Andere Statuscodes	Fehler.

Bemerkungen

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

Anforderungen

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

Siehe auch

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsFlowAssociateContext0

klassifizierenFn-

flowDeleteFn

Freigeben über