FwpmCalloutDeleteByKey0-Funktion (fwpmk.h)

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

HinweisFwpmCalloutDeleteByKey0 ist eine bestimmte Version von FwpmCalloutDeleteByKey. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und Spezifische Windows-Versionen .

 

Syntax

NTSTATUS FwpmCalloutDeleteByKey0(
  [in] HANDLE     engineHandle,
  [in] const GUID *key
);

Parameter

[in] engineHandle

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

[in] key

Ein Zeiger auf eine GUID, die die Legende eindeutig identifiziert, die aus der Filter-Engine gelöscht wird. Dies muss ein Zeiger auf dieselbe GUID sein, die angegeben wurde, als der Legendentreiber die Funktion FwpmCalloutAdd0 aufgerufen hat, um die Legende der Filter-Engine hinzuzufügen.

Rückgabewert

Die Funktion FwpmCalloutDeleteByKey0 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 Legende in der Filter-Engine, die der im key-Parameter angegebenen GUID entspricht.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

Ein Legendentreiber ruft die FwpmCalloutDeleteByKey0-Funktion auf, um eine Legende aus der Filter-Engine zu löschen, wobei die GUID-Taste 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 Verwaltungsanwendung für die Windows-Filterplattform im Benutzermodus behandelt.

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 (schließen Sie Fwpmk.h ein)
Bibliothek	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL

Weitere Informationen

FwpmCalloutAdd0

FwpmCalloutDeleteById0

FwpmEngineOpen0