FwpsClassifyOptionSet0-Funktion (fwpsk.h)

Artikel
08/07/2023

Die Funktion FwpsClassifyOptionSet0 wird von der Funktion klassifizierenFn eines Legendenfilters 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 Zielgruppenspezifische Windows-Versionen .

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 sich der newValue-Parameter auf Unicast-, Multicast- oder lose Quellzuordnungszustände oder auf Datentimeoutwerte bezieht. 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 Konstanten. 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	Der Optionsparameter entspricht keinem der Werte im FWP_CLASSIFY_OPTION_TYPE Enumeration.
STATUS_FWP_OUT_OF_BOUNDS	Der von newValue -> uint32 angegebene Optionswert enthält keinen der definierten FWP_OPTION_VALUE_XXX Konstantenwerte.
STATUS_OBJECT_TYPE_MISMATCH	Der vom newValue-Typ -> angegebene Datentyp wurde nicht FWP_UINT32.
STATUS_UNSUCCESSFUL	Ein allgemeiner Fehler ist aufgetreten.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

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

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

Option Parameter	newValue->typ 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 Zulassen der Erstellung eines link-lokalen Multicastzustands für ausgehenden Datenverkehr. FWP_OPTION_VALUE_DENY_MULTICAST_STATE Lassen Sie die Erstellung eines linklokalen Multicastzustands für ausgehenden Datenverkehr nicht zu. FWP_OPTION_VALUE_ALLOW_NON_LINK_LOCAL_RESPONSE Zulassen der Erstellung eines Multicastzustands für ausgehenden Datenverkehr (zulässt nicht link-lokale Antworten).
FWP_CLASSIFY_OPTION_MCAST_BCAST_LIFETIME	FWP_UINT32 > 0	Gibt die Lebensdauer des Multicast-/Broadcast-Zustands in Sekunden an.
FWP_CLASSIFY_OPTION_UNICAST_LIFETIME	FWP_UINT32 > 0	Gibt die Lebensdauer des Unicastzustands in Sekunden an.

Dem ersten Aufrufer (höchste Gewichtung), der eine bestimmte Option festlegen soll, wird diese Option gewährt. Wenn z. B. Die Legende A die Multicaststatusoption festlegt, ist dies nicht möglich, aber Legende B kann andere Optionen festlegen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows Vista.
Zielplattform	Universell
Header	fwpsk.h (include fwpsk.h)
Bibliothek	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL