énumération FWP_MATCH_TYPE (fwptypes.h)

Article
03/11/2023

Le FWP_MATCH_TYPE type énuméré spécifie différents types de correspondance autorisés dans les conditions de filtre.

Syntaxe

typedef enum FWP_MATCH_TYPE_ {
  FWP_MATCH_EQUAL = 0,
  FWP_MATCH_GREATER,
  FWP_MATCH_LESS,
  FWP_MATCH_GREATER_OR_EQUAL,
  FWP_MATCH_LESS_OR_EQUAL,
  FWP_MATCH_RANGE,
  FWP_MATCH_FLAGS_ALL_SET,
  FWP_MATCH_FLAGS_ANY_SET,
  FWP_MATCH_FLAGS_NONE_SET,
  FWP_MATCH_EQUAL_CASE_INSENSITIVE,
  FWP_MATCH_NOT_EQUAL,
  FWP_MATCH_PREFIX,
  FWP_MATCH_NOT_PREFIX,
  FWP_MATCH_TYPE_MAX
} FWP_MATCH_TYPE;

Constantes


`FWP_MATCH_EQUAL` Valeur : 0 Teste si la valeur est égale à la valeur de condition. Tous les types de données prennent en charge les FWP_MATCH_EQUAL.
`FWP_MATCH_GREATER` Teste si la valeur est supérieure à la valeur de condition. Seuls les types de données triables prennent en charge les FWP_MATCH_GREATER. Les types de données triables se composent de tous les types entiers, FWP_BYTE_ARRAY16_TYPE, FWP_BYTE_BLOB_TYPE et FWP_UNICODE_STRING_TYPE.
`FWP_MATCH_LESS` Teste si la valeur est inférieure à la valeur de condition. Seuls les types de données triables prennent en charge les FWP_MATCH_LESS.
`FWP_MATCH_GREATER_OR_EQUAL` Teste si la valeur est supérieure ou égale à la valeur de condition. Seuls les types de données triables prennent en charge les FWP_MATCH_GREATER_OR_EQUAL.
`FWP_MATCH_LESS_OR_EQUAL` Teste si la valeur est inférieure ou égale à la valeur de condition. Seuls les types de données triables prennent en charge les FWP_MATCH_LESS_OR_EQUAL.
`FWP_MATCH_RANGE` Teste si la valeur se trouve dans une plage donnée de valeurs de condition. Seuls les types de données triables prennent en charge les FWP_MATCH_RANGE.
`FWP_MATCH_FLAGS_ALL_SET` Teste si tous les indicateurs sont définis. Seuls les types de données entiers non signés prennent en charge les FWP_MATCH_FLAGS_ALL_SET.
`FWP_MATCH_FLAGS_ANY_SET` Teste si des indicateurs sont définis. Seuls les types de données entiers non signés prennent en charge les FWP_MATCH_FLAGS_ANY_SET.
`FWP_MATCH_FLAGS_NONE_SET` Teste si aucun indicateur n’est défini. Seuls les types de données entiers non signés prennent en charge FWP_MATCH_FLAGS_NONE_SET.
`FWP_MATCH_EQUAL_CASE_INSENSITIVE` Teste si la valeur est égale à la valeur de condition. Le test n’est pas sensible à la casse. Seul le type de données FWP_UNICODE_STRING_TYPE prend en charge FWP_MATCH_EQUAL_CASE_INSENSITIVE.
`FWP_MATCH_NOT_EQUAL` Teste si la valeur n’est pas égale à la valeur de condition. Seuls les types de données triables prennent en charge les FWP_MATCH_NOT_EQUAL. Note Disponible uniquement dans Windows 7 et Windows Server 2008 R2.
`FWP_MATCH_PREFIX` Cet indicateur a un nom trompeur. Il teste si la valeur se termine par la valeur de condition, c’est-à-dire le suffixe, et non le préfixe. Les types FWP_BYTE_BLOB_TYPE (lorsqu’il contient une chaîne) et FWP_UNICODE_STRING_TYPE prennent en charge ce type de correspondance.
`FWP_MATCH_NOT_PREFIX` Cet indicateur a un nom trompeur. Il vérifie si la valeur ne se termine pas par la valeur de condition, c’est-à-dire qu’elle vérifie le suffixe, et non le préfixe. Les types FWP_BYTE_BLOB_TYPE (lorsqu’il contient une chaîne) et FWP_UNICODE_STRING_TYPE prennent en charge ce type de correspondance.
`FWP_MATCH_TYPE_MAX` Valeur maximale à des fins de test. Ne vous fiez pas à cette valeur dans le code, car elle peut changer lorsque vous recompilez avec un KIT de développement logiciel (SDK) plus récent.

Remarques

En général, le type de données value et le type de données de condition de filtre doivent être identiques. Le moteur de filtrage de base (BFE) n’effectue aucune conversion de données. Par exemple, une valeur FWP_UINT32 ne peut pas être comparée à une valeur FWP_UINT16.

Les exceptions à cette règle sont les suivantes.

Un champ FWP_UINT32 qui contient une adresse IPv4 peut être comparé à une valeur FWP_V4_ADDR_MASK.
Un champ FWP_BYTE_ARRAY16_TYPE qui contient une adresse IPv6 peut être comparé à une valeur FWP_V6_ADDR_MASK.
Un champ FWP_TOKEN_INFORMATION_TYPE peut être comparé à une valeur FWP_SECURITY_DESCRIPTOR_TYPE lors de l’ajout de filtres.
Un champ FWP_TOKEN_ACCESS_INFORMATION_TYPE peut être comparé à une valeur FWP_SECURITY_DESCRIPTOR_TYPE lors de l’ajout de filtres.
Un champ FWP_TOKEN_INFORMATION_TYPE peut être comparé à une valeur FWP_SID lors de l’énumération.
Un champ FWP_TOKEN_ACCESS_INFORMATION_TYPE peut être comparé à une valeur FWP_SID lors de l’énumération.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	fwptypes.h

Voir aussi

Structures d’API de plateforme de filtrage Windows

Partager via