FwpmCalloutDeleteById0-Funktion (fwpmk.h)

  • Artikel

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

Syntax

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

Parameter

[in] engineHandle

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

[in] id

Der Laufzeitbezeichner für die Legende, die aus dem Filtermodul gelöscht wird. Dies muss der Laufzeitbezeichner sein, der zurückgegeben wurde, wenn der Beschriftungstreiber FwpmCalloutAdd0 Funktion aufgerufen wurde, um die Legende dem Filtermodul hinzuzufügen.

Rückgabewert

Die funktion FwpmCalloutDeleteById0 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 dem in der ID Parameter angegebenen Laufzeitbezeichner entspricht.
Andere NTSTATUS-Codes Fehler.

Bemerkungen

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 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.

FwpmCalloutDeleteById0 ist eine bestimmte Version von FwpmCalloutDeleteById. 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