FwpmCalloutAdd0-Funktion (fwpmk.h)

Die FwpmCalloutAdd0--Funktion fügt dem Filtermodul eine Legende hinzu.

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 für das Filtermodul. Ein Popuptreiber ruft die FwpmEngineOpen0--Funktion 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 zum Filtermodul erforderlich sind.

[in, optional] sd

Ein Zeiger auf eine Konstante SECURITY_DESCRIPTOR Struktur, die den Sicherheitsdeskriptor für die Legende beschreibt, die dem Filtermodul hinzugefügt wird. Dieser Parameter ist optional und kann NULL-werden.

[out, optional] id

Ein Zeiger auf eine UINT32-Typvariable, die einen Laufzeitbezeichner empfängt, der die Legende im Filtermodul identifiziert. Dies ist derselbe Bezeichner, der zurückgegeben wird, wenn ein Beschriftungstreiber die Legendenfunktionen des Popuptreibers mit dem Filtermodul registriert. Der Beschriftungstreiber übergibt diesen Bezeichner an die FwpmCalloutDeleteById0 Funktion, wenn die Legende aus dem Filtermodul entfernt wird. Dieser Parameter ist optional und kann NULL-werden.

Rückgabewert

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

Rückgabecode Beschreibung
STATUS_SUCCESS Die Legende wurde dem Filtermodul erfolgreich hinzugefügt.
STATUS_FWP_ALREADY_EXISTS Die Legende konnte dem Filtermodul nicht hinzugefügt werden. Eine Legende ist bereits im Filtermodul mit einem Bezeichner vorhanden, der mit der guiD identisch ist, die im calloutKey Member der FWPM_CALLOUT0 Struktur durch den Legendenparameter-Parameter verweist.
Andere NTSTATUS-Codes Fehler.

Bemerkungen

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

Legendentreiber fügen ihre Legenden in der Regel nicht zum Filtermodul hinzu. In den meisten Fällen wird dies von einer Windows-Filterplattform-Verwaltungsanwendung im Benutzermodus behandelt.

Eine Legende und Filter, die die Legende für die Aktion des Filters angeben, können dem Filtermodul hinzugefügt werden, bevor ein Popuptreiber die Legende mit dem Filtermodul registriert. In diesem Fall 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.

FwpmCalloutAdd0 ist eine bestimmte Version von FwpmCalloutAdd. 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