fwpmCalloutDeleteById0-Funktion (fwpmk.h)

Artikel
02/29/2024

Die Funktion fwpmCalloutDeleteById0 löscht eine Legende aus der Filter-Engine.

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

Syntax

NTSTATUS FwpmCalloutDeleteById0(
  [in] HANDLE engineHandle,
  [in] UINT32 id
);

Parameter

[in] engineHandle

Ein Handle für eine geöffnete Sitzung der Filter-Engine. Ein Legendentreiber ruft die Funktion FwpmEngineOpen0 auf, um eine Sitzung für das Filtermodul zu öffnen.

[in] id

Der Laufzeitbezeichner für die Legende, die aus der Filter-Engine gelöscht wird. Dies muss der Laufzeitbezeichner sein, der zurückgegeben wurde, als der Legendentreiber die Funktion FwpmCalloutAdd0 aufgerufen hat, um die Legende der Filter-Engine hinzuzufügen.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Legende wurde erfolgreich aus der Filter-Engine gelöscht.
STATUS_FWP_IN_USE	Mindestens ein Filter in der Filter-Engine gibt die Beschriftung für die Aktion des Filters an.
STATUS_FWP_CALLOUT_NOT_FOUND	Es gibt keine Beschriftung in der Filter-Engine, die dem Laufzeitbezeichner entspricht, der im id-Parameter angegeben ist.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

Ein Legendentreiber ruft die FwpmCalloutDeleteById0-Funktion auf, um eine Legende aus dem Filtermodul zu löschen, wobei der Laufzeitbezeichner verwendet wird, um die zu löschende Legende zu identifizieren.

Legendentreiber löschen ihre Legenden in der Regel nicht aus der Filter-Engine. In den meisten Fällen wird dies von einer Windows-Filterplattform-Verwaltungsanwendung im Benutzermodus verarbeitet.

Eine Legende kann nur aus der Filter-Engine gelöscht werden, wenn keine Filter in der Filter-Engine vorhanden sind, die die Legende für die Aktion des Filters angeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows Vista.
Zielplattform	Universell
Header	fwpmk.h (einschließlich Fwpmk.h)
Bibliothek	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL

Weitere Informationen

FwpmCalloutAdd0

FwpmCalloutDeleteByKey0

FwpmEngineOpen0

Freigeben über