Funzione FwpsClassifyOptionSet0 (fwpsk.h)

Articolo
08/07/2023

La funzione FwpsClassifyOptionSet0 viene chiamata dalla funzione di classificazione del filtro callout 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 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 di FWPS_INCOMING_METADATA_VALUES0 . Questa struttura contiene i valori per ognuno dei campi dei metadati a livello filtrato.

[in] option

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

[in] newValue

Puntatore a una matrice di strutture FWP_VALUE0 . Ogni struttura della matrice contiene valori specifici per una determinata costante FWP_OPTION_VALUE_XXX. Per altre informazioni, vedere la sezione 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	Il parametro dell'opzione non corrisponde a nessuno dei valori nell'oggetto 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 è FWP_UINT32.
STATUS_UNSUCCESSFUL	Si è verificato un errore generale.
Altri codici di stato	Si è verificato un errore.

Commenti

Questa funzione deve essere chiamata solo dalla funzione di classificazioneFn di un filtro callout.

Di seguito sono riportati i valori consentiti del parametro di opzione e dei membri della struttura FWP_VALUE0 puntati dal parametro newValue .

Opzione Parametro	valore del tipo newValue->	valore newValue->uint32
FWP_CLASSIFY_OPTION_LOOSE_SOURCE_MAPPING	FWP_UINT32	FWP_OPTION_VALUE_ENABLE_LOOSE_SOURCE Abilitare il mapping di origine libero. FWP_OPTION_VALUE_DISABLE_LOOSE_SOURCE Disabilitare il mapping di origine libero.
FWP_CLASSIFY_OPTION_MULTICAST_STATE	FWP_UINT32	FWP_OPTION_VALUE_ALLOW_MULTICAST_STATE Consenti 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 Consenti la creazione dello stato multicast per il traffico in uscita (consentendo risposte locali non link).
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.

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

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows Vista.
Piattaforma di destinazione	Universale
Intestazione	fwpsk.h (includere Fwpsk.h)
Libreria	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL