FwpsClassifyOptionSet0-Funktion (fwpsk.h)

Artikel
02/07/2025

Die FwpsClassifyOptionSet0--Funktion wird von der klassifizierenFn-Funktion eines Popupfilters aufgerufen, um zusätzliche Informationen anzugeben, die sich auf die Merkmale zulässiger Filtervorgänge auswirken.

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

Syntax

NTSTATUS FwpsClassifyOptionSet0(
  [in] const FWPS_INCOMING_METADATA_VALUES0 *inMetadataValues,
  [in] const FWP_CLASSIFY_OPTION_TYPE       option,
  [in] const FWP_VALUE0                     *newValue
);

Parameter

[in] inMetadataValues

Ein Zeiger auf eine FWPS_INCOMING_METADATA_VALUES0 Struktur. Diese Struktur enthält die Werte für jedes Metadatenfeld auf der Ebene, die gefiltert wird.

[in] option

Eine FWP_CLASSIFY_OPTION_TYPE Enumerationskonstante, die angibt, ob der newValue--Parameter auf Unicast-, Multicast- oder lose Quellzuordnungszustände oder Datentimeoutwerte verweist. Weitere Informationen finden Sie in den Hinweisen.

[in] newValue

Ein Zeiger auf ein Array von FWP_VALUE0 Strukturen. Jede Struktur im Array enthält bestimmte Werte für eine bestimmte FWP_OPTION_VALUE_XXX Konstante. Weitere Informationen finden Sie in den Hinweisen.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion wurde erfolgreich abgeschlossen.
STATUS_FWP_INVALID_ENUMERATOR	Die option Parameter stimmt nicht mit den Werten im FWP_CLASSIFY_OPTION_TYPE Enumeration.
STATUS_FWP_OUT_OF_BOUNDS	Der durch newValue -> uint32- angegebene Optionswert enthält keinen der definierten FWP_OPTION_VALUE_XXX Konstantenwerte.
STATUS_OBJECT_TYPE_MISMATCH	Der durch newValue -> Type angegebene Datentyp wurde nicht FWP_UINT32.
STATUS_UNSUCCESSFUL	Ein allgemeiner Fehler ist aufgetreten.
Andere Statuscodes	Fehler.

Bemerkungen

Diese Funktion sollte nur von der klassifizierenFn- funktion eines Popupfilters aufgerufen werden.

Im Folgenden sind die zulässigen Werte des Option Parameter und Member der FWP_VALUE0 Struktur aufgeführt, auf die der newValue-Parameter verweist.

Option Parameter	newValue->type Value	newValue->uint32 Value
FWP_CLASSIFY_OPTION_LOOSE_SOURCE_MAPPING	FWP_UINT32	FWP_OPTION_VALUE_ENABLE_LOOSE_SOURCE Aktivieren Sie die lose Quellzuordnung. FWP_OPTION_VALUE_DISABLE_LOOSE_SOURCE Deaktivieren Sie die lose Quellzuordnung.
FWP_CLASSIFY_OPTION_MULTICAST_STATE	FWP_UINT32	FWP_OPTION_VALUE_ALLOW_MULTICAST_STATE Allow link-local multicast state creation on outbound traffic. FWP_OPTION_VALUE_DENY_MULTICAST_STATE Die Erstellung des link-lokalen Multicastzustands für ausgehenden Datenverkehr nicht zulassen. FWP_OPTION_VALUE_ALLOW_NON_LINK_LOCAL_RESPONSE Die Erstellung des Multicastzustands für ausgehenden Datenverkehr zulassen (zulassen, dass nicht verknüpfungsgebundene lokale Antworten zulässig sind).
FWP_CLASSIFY_OPTION_MCAST_BCAST_LIFETIME	FWP_UINT32 > 0	Gibt die Lebensdauer des Multicast-/Übertragungszustands in Sekunden an.
FWP_CLASSIFY_OPTION_UNICAST_LIFETIME	FWP_UINT32 > 0	Gibt die Unicaststatuslebensdauer in Sekunden an.

Der erste Aufrufer (höchste Gewichtung) zum Festlegen einer bestimmten Option wird dieser Option gewährt. Wenn beispielsweise Legende A die Multicaststatusoption festlegt, kann die Legende B dies nicht tun, aber Legende B kann andere Optionen festlegen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar ab Windows Vista.
Zielplattform-	Universal
Header-	fwpsk.h (include Fwpsk.h)
Library	Fwpkclnt.lib
IRQL-	<= DISPATCH_LEVEL