FwpsClassifyOptionSet0, fonction (fwpsk.h)

Article
07/02/2025

La fonction FwpsClassifyOptionSet0 est appelée par la fonction classifieFn de 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 PAM Version-Independent noms et ciblage de versions spécifiques de 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 au niveau 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 à des états de mappage unicast, multidiffusion ou à des valeurs de délai d’attente de données. Pour plus d’informations, consultez Remarques.

[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 Remarques.

Valeur de retour

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

Retourner le code	Description
STATUS_SUCCESS	La fonction s’est terminée correctement.
STATUS_FWP_INVALID_ENUMERATOR	L’option paramètre ne correspond à aucune des valeurs dans le énumération FWP_CLASSIFY_OPTION_TYPE.
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 d’état	Une erreur s’est produite.

Remarques

Cette fonction doit être appelée uniquement par la fonction classifiezFn de filtre de légende.

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

option Paramètre	newValue->type Value	newValue->uint32 Value
FWP_CLASSIFY_OPTION_LOOSE_SOURCE_MAPPING	FWP_UINT32	FWP_OPTION_VALUE_ENABLE_LOOSE_SOURCE Activez le mappage source libre. FWP_OPTION_VALUE_DISABLE_LOOSE_SOURCE Désactivez le mappage source libre.
FWP_CLASSIFY_OPTION_MULTICAST_STATE	FWP_UINT32	FWP_OPTION_VALUE_ALLOW_MULTICAST_STATE Autoriser la création d’état de multidiffusion locale de liaison 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 non liées).
FWP_CLASSIFY_OPTION_MCAST_BCAST_LIFETIME	FWP_UINT32 > 0	Spécifie la durée de vie de la 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.

Le premier appelant (poids le plus élevé) pour définir une option particulière sera accordé à cette option. 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible à partir de Windows Vista.
plateforme cible	Universel
d’en-tête	fwpsk.h (include Fwpsk.h)
bibliothèque	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL