FwpsFlowRemoveContext0-Funktion (fwpsk.h)
Die FwpsFlowRemoveContext0-Funktion entfernt einen zuvor zugeordneten Kontext aus einem Datenfluss.
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 |
|---|---|
|
Der Kontext wurde erfolgreich aus dem Datenfluss entfernt. |
|
Dem Datenfluss ist derzeit kein Kontext zugeordnet. |
|
Eine aktive Legendenklassifizierung wird ausgeführt. |
|
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 |