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 |