Fonction FwpsClassifyOptionSet0 (fwpsk.h)

Article
02/26/2024

La fonction FwpsClassifyOptionSet0 est appelée par la fonction classifyFn d’un filtre de légende pour spécifier des informations supplémentaires qui affectent les caractéristiques des opérations de filtrage autorisées.

RemarqueFwpsClassifyOptionSet0 est une version spécifique de FwpsClassifyOptionSet. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows .

Syntaxe

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

Paramètres

[in] inMetadataValues

Pointeur vers une structure FWPS_INCOMING_METADATA_VALUES0 . Cette structure contient les valeurs de chacun des champs de métadonnées de la couche filtrée.

[in] option

Constante d’énumération FWP_CLASSIFY_OPTION_TYPE qui indique si le paramètre newValue fait référence à la monodiffusion, à la multidiffusion ou à des états de mappage de source libre, ou à des valeurs de délai d’attente de données. Pour plus d'informations, consultez la section Notes.

[in] newValue

Pointeur vers un tableau de structures FWP_VALUE0 . Chaque structure du tableau contient des valeurs particulières pour une constante FWP_OPTION_VALUE_XXX particulière. Pour plus d'informations, consultez la section Notes.

Valeur retournée

La fonction FwpsClassifyOptionSet0 retourne l’un des codes NTSTATUS suivants.

Code de retour	Description
STATUS_SUCCESS	La fonction s’est terminée avec succès.
STATUS_FWP_INVALID_ENUMERATOR	Le paramètre d’option ne correspond à aucune des valeurs dans le FWP_CLASSIFY_OPTION_TYPE énumération.
STATUS_FWP_OUT_OF_BOUNDS	La valeur d’option spécifiée par newValue -> uint32 n’inclut pas l’une des valeurs constantes FWP_OPTION_VALUE_XXX définies.
STATUS_OBJECT_TYPE_MISMATCH	Le type de données spécifié par newValue -> Type n’a pas été FWP_UINT32.
STATUS_UNSUCCESSFUL	Une erreur générale s’est produite.
Autres codes status	Une erreur est survenue.

Remarques

Cette fonction doit être appelée uniquement par la fonction classifyFn d’un filtre de légende.

Voici les valeurs autorisées du paramètre d’option et les membres de la structure FWP_VALUE0 pointée par le paramètre newValue .

Option Paramètre	newValue->type Value	valeur newValue->uint32
FWP_CLASSIFY_OPTION_LOOSE_SOURCE_MAPPING	FWP_UINT32	FWP_OPTION_VALUE_ENABLE_LOOSE_SOURCE Activez le mappage de source libre. FWP_OPTION_VALUE_DISABLE_LOOSE_SOURCE Désactivez le mappage de source libre.
FWP_CLASSIFY_OPTION_MULTICAST_STATE	FWP_UINT32	FWP_OPTION_VALUE_ALLOW_MULTICAST_STATE Autoriser la création d’un état de multidiffusion local de lien sur le trafic sortant. FWP_OPTION_VALUE_DENY_MULTICAST_STATE N’autorisez pas la création d’état de multidiffusion locale de lien sur le trafic sortant. FWP_OPTION_VALUE_ALLOW_NON_LINK_LOCAL_RESPONSE Autoriser la création d’état de multidiffusion pour le trafic sortant (autorisant les réponses locales sans lien).
FWP_CLASSIFY_OPTION_MCAST_BCAST_LIFETIME	FWP_UINT32 > 0	Spécifie la durée de vie de l’état de multidiffusion/diffusion, en secondes.
FWP_CLASSIFY_OPTION_UNICAST_LIFETIME	FWP_UINT32 > 0	Spécifie la durée de vie de l’état de monodiffusion, en secondes.

Cette option est accordée au premier appelant (poids le plus élevé) pour définir une option particulière. Par exemple, si la légende A définit l’option d’état de multidiffusion, la légende B ne pourra pas le faire, mais la légende B peut définir d’autres options.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows Vista.
Plateforme cible	Universal
En-tête	fwpsk.h (include Fwpsk.h)
Bibliothèque	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL