FwpmCalloutAdd0-Funktion (fwpmk.h)

  • Artikel

Die Funktion fwpmCalloutAdd0 fügt dem Filtermodul eine Legende hinzu.

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

Syntax

NTSTATUS FwpmCalloutAdd0(
  [in]            HANDLE               engineHandle,
  [in]            const FWPM_CALLOUT0  *callout,
  [in, optional]  PSECURITY_DESCRIPTOR sd,
  [out, optional] 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] callout

Ein Zeiger auf eine konstante FWPM_CALLOUT0 Struktur, die die Daten enthält, die zum Hinzufügen der Legende zur Filter-Engine erforderlich sind.

[in, optional] sd

Ein Zeiger auf eine konstante SECURITY_DESCRIPTOR Struktur, die den Sicherheitsdeskriptor für die Legende beschreibt, die der Filter-Engine hinzugefügt wird. Dieser Parameter ist optional und kann NULL sein.

[out, optional] id

Ein Zeiger auf eine Variable mit UINT32-Typ, die einen Laufzeitbezeichner empfängt, der die Legende in der Filter-Engine identifiziert. Dies ist derselbe Bezeichner, der zurückgegeben wird, wenn ein Legendentreiber die Legendenfunktionen des Legendentreibers bei der Filter-Engine registriert. Der Legendentreiber übergibt diesen Bezeichner an die Funktion FwpmCalloutDeleteById0 , wenn die Legende aus der Filter-Engine entfernt wird. Dieser Parameter ist optional und kann NULL sein.

Rückgabewert

Die FwpmCalloutAdd0-Funktion gibt einen der folgenden NTSTATUS-Codes zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS
 Die Legende wurde der Filter-Engine erfolgreich hinzugefügt.
STATUS_FWP_ALREADY_EXISTS
 Die Legende konnte der Filter-Engine nicht hinzugefügt werden. In der Filter-Engine ist bereits eine Legende vorhanden, deren Bezeichner mit der GUID identisch ist, die im calloutKey-Member der FWPM_CALLOUT0 Struktur angegeben ist, auf die der Legendenparameter verweist.
Andere status Codes
 Ein Fehler ist aufgetreten.

Hinweise

Ein Legendentreiber ruft die Funktion FwpmCalloutAdd0 auf, um dem Filtermodul eine Legende hinzuzufügen.

Legendentreiber fügen ihre Legenden in der Regel nicht zur Filter-Engine hinzu. In den meisten Situationen wird dies von einer Windows-Filterplattform-Verwaltungsanwendung im Benutzermodus behandelt.

Eine Legende und Filter, die die Beschriftung für die Aktion des Filters angeben, können der Filter-Engine hinzugefügt werden, bevor ein Legendentreiber die Legende bei der Filter-Engine registriert. In dieser Situation werden Filter mit einem Aktionstyp von FWP_ACTION_CALLOUT_TERMINATING oder FWP_ACTION_CALLOUT_UNKNOWN als FWP_ACTION_BLOCK behandelt, und Filter mit einem Aktionstyp von FWP_ACTION_CALLOUT_INSPECTION werden ignoriert, bis die Legende beim Filtermodul registriert ist.

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

FWPM_CALLOUT0

fwpmCalloutDeleteById0

FwpmCalloutDeleteByKey0

FwpmEngineOpen0

Typen von Legenden