Freigeben über

FwpmCalloutDeleteByKey0-Funktion (fwpmk.h)

  • Artikel

Die FwpmCalloutDeleteByKey0-Funktion löscht eine Legende aus dem Filtermodul.

Syntax

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

Parameter

[in] engineHandle

Ein Handle für eine geöffnete Sitzung für das Filtermodul. Ein "Callout"-Treiber ruft die FwpmEngineOpen0-Funktion auf, um eine Sitzung für das Filtermodul zu öffnen.

[in] key

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

Rückgabewert

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

Rückgabecode Beschreibung
STATUS_SUCCESS Die Legende wurde erfolgreich aus dem Filtermodul gelöscht.
STATUS_FWP_IN_USE Mindestens ein Filter im Filtermodul gibt die Legende für die Aktion des Filters an.
STATUS_FWP_CALLOUT_NOT_FOUND Es gibt keine Legende im Filtermodul, die der im schlüssel Parameter angegebenen GUID entspricht.
Andere NTSTATUS-Codes Fehler.

Bemerkungen

Ein Beschriftungstreiber ruft die FwpmCalloutDeleteByKey0-Funktion auf, um eine Legende aus dem Filtermodul zu löschen. Verwenden Sie dazu die GUID-Taste, um die zu löschende Legende zu identifizieren.

Legendentreiber löschen ihre Legenden in der Regel nicht aus dem Filtermodul. In den meisten Fällen wird dies von einem Benutzermodus Windows-Filterplattform Verwaltungsanwendung behandelt.

Eine Legende kann nur aus dem Filtermodul gelöscht werden, wenn im Filtermodul keine Filter vorhanden sind, die die Legende für die Aktion des Filters angeben.

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

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Verfügbar ab Windows Vista.
Zielplattform- Universal
Header- fwpmk.h (include Fwpmk.h)
Library Fwpkclnt.lib
IRQL- PASSIVE_LEVEL

Siehe auch