Funzione FwpsClassifyOptionSet0 (fwpsk.h)

Articolo
02/07/2025

La funzione FwpsClassifyOptionSet0 viene chiamata dalla funzione di un filtro callout classifyFn per specificare informazioni aggiuntive che influiscono sulle caratteristiche delle operazioni di filtro consentite.

NotaFwpsClassifyOptionSet0 è una versione specifica di FwpsClassifyOptionSet. Per altre informazioni, vedere nomi Version-Independent WFP e selezione di versioni specifiche di Windows.

Sintassi

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

Parametri

[in] inMetadataValues

Puntatore a una struttura FWPS_INCOMING_METADATA_VALUES0. Questa struttura contiene i valori per ognuno dei campi di metadati a livello filtrato.

[in] option

Costante di enumerazione FWP_CLASSIFY_OPTION_TYPE che indica se il parametro newValue fa riferimento a stati unicast, multicast o mapping di origine separati o a valori di timeout dei dati. Per altre informazioni, vedere Osservazioni.

[in] newValue

Puntatore a una matrice di strutture FWP_VALUE0. Ogni struttura nella matrice contiene valori specifici per una determinata costante FWP_OPTION_VALUE_XXX. Per altre informazioni, vedere Osservazioni.

Valore restituito

La funzione FwpsClassifyOptionSet0 restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	La funzione è stata completata correttamente.
STATUS_FWP_INVALID_ENUMERATOR	L'opzione parametro non corrisponde ad alcun valore nel FWP_CLASSIFY_OPTION_TYPE'enumerazione .
STATUS_FWP_OUT_OF_BOUNDS	Il valore dell'opzione specificato da newValue -> uint32 non include uno dei valori costanti FWP_OPTION_VALUE_XXX definiti.
STATUS_OBJECT_TYPE_MISMATCH	Il tipo di dati specificato da newValue -> Type non è stato FWP_UINT32.
STATUS_UNSUCCESSFUL	Si è verificato un errore generale.
Altri codici di stato	Si è verificato un errore.

Osservazioni

Questa funzione deve essere chiamata solo da un filtro callout la funzione classifyFn.

Di seguito sono riportati i valori consentiti dell'opzione parametro e membri della struttura FWP_VALUE0 a cui punta il parametro newValue.

opzione parametro	newValue- tipo>Valore	newValue->valore uint32
FWP_CLASSIFY_OPTION_LOOSE_SOURCE_MAPPING	FWP_UINT32	FWP_OPTION_VALUE_ENABLE_LOOSE_SOURCE Abilitare il mapping di origine libera. FWP_OPTION_VALUE_DISABLE_LOOSE_SOURCE Disabilitare il mapping di origine libera.
FWP_CLASSIFY_OPTION_MULTICAST_STATE	FWP_UINT32	FWP_OPTION_VALUE_ALLOW_MULTICAST_STATE Consentire la creazione dello stato multicast locale del collegamento nel traffico in uscita. FWP_OPTION_VALUE_DENY_MULTICAST_STATE Non consentire la creazione dello stato multicast locale del collegamento nel traffico in uscita. FWP_OPTION_VALUE_ALLOW_NON_LINK_LOCAL_RESPONSE Consentire la creazione dello stato multicast per il traffico in uscita (consentendo risposte locali non di collegamento).
FWP_CLASSIFY_OPTION_MCAST_BCAST_LIFETIME	FWP_UINT32 > 0	Specifica la durata dello stato multicast/broadcast, in secondi.
FWP_CLASSIFY_OPTION_UNICAST_LIFETIME	FWP_UINT32 > 0	Specifica la durata dello stato unicast, in secondi.

Al primo chiamante (peso più alto) per impostare una particolare opzione verrà concessa tale opzione. Ad esempio, se il callout A imposta l'opzione di stato multicast, il callout B non sarà in grado di farlo, ma il callout B può impostare altre opzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile a partire da Windows Vista.
piattaforma di destinazione	Universale
intestazione	fwpsk.h (include Fwpsk.h)
libreria	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL