enumerazione FWP_MATCH_TYPE (fwptypes.h)

Articolo
03/11/2023

Il tipo enumerato FWP_MATCH_TYPE specifica tipi di corrispondenza diversi consentiti nelle condizioni di filtro.

Sintassi

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;

Costanti


`FWP_MATCH_EQUAL` Valore: 0 Verifica se il valore è uguale al valore della condizione. Tutti i tipi di dati supportano FWP_MATCH_EQUAL.
`FWP_MATCH_GREATER` Verifica se il valore è maggiore del valore della condizione. Solo i tipi di dati ordinabili supportano FWP_MATCH_GREATER. I tipi di dati ordinabili sono costituiti da tutti i tipi Integer, FWP_BYTE_ARRAY16_TYPE, FWP_BYTE_BLOB_TYPE e FWP_UNICODE_STRING_TYPE.
`FWP_MATCH_LESS` Verifica se il valore è minore del valore della condizione. Solo i tipi di dati ordinabili supportano FWP_MATCH_LESS.
`FWP_MATCH_GREATER_OR_EQUAL` Verifica se il valore è maggiore o uguale al valore della condizione. Solo i tipi di dati ordinabili supportano FWP_MATCH_GREATER_OR_EQUAL.
`FWP_MATCH_LESS_OR_EQUAL` Verifica se il valore è minore o uguale al valore della condizione. Solo i tipi di dati ordinabili supportano FWP_MATCH_LESS_OR_EQUAL.
`FWP_MATCH_RANGE` Verifica se il valore è compreso in un determinato intervallo di valori di condizione. Solo i tipi di dati ordinabili supportano FWP_MATCH_RANGE.
`FWP_MATCH_FLAGS_ALL_SET` Verifica se tutti i flag sono impostati. Solo i tipi di dati integer senza segno supportano FWP_MATCH_FLAGS_ALL_SET.
`FWP_MATCH_FLAGS_ANY_SET` Verifica se sono impostati flag. Solo i tipi di dati integer senza segno supportano FWP_MATCH_FLAGS_ANY_SET.
`FWP_MATCH_FLAGS_NONE_SET` Verifica se non sono impostati flag. Solo i tipi di dati integer senza segno supportano FWP_MATCH_FLAGS_NONE_SET.
`FWP_MATCH_EQUAL_CASE_INSENSITIVE` Verifica se il valore è uguale al valore della condizione. Il test non fa distinzione tra lettere maiuscole e minuscole. Solo il tipo di dati FWP_UNICODE_STRING_TYPE supporta FWP_MATCH_EQUAL_CASE_INSENSITIVE.
`FWP_MATCH_NOT_EQUAL` Verifica se il valore non è uguale al valore della condizione. Solo i tipi di dati ordinabili supportano FWP_MATCH_NOT_EQUAL. Nota Disponibile solo in Windows 7 e Windows Server 2008 R2.
`FWP_MATCH_PREFIX` Questo flag ha un nome fuorviante. Verifica se il valore termina con il valore della condizione, ovvero il suffisso, non il prefisso. I tipi FWP_BYTE_BLOB_TYPE (quando contiene una stringa) e FWP_UNICODE_STRING_TYPE supportano questo tipo di corrispondenza.
`FWP_MATCH_NOT_PREFIX` Questo flag ha un nome fuorviante. Verifica se il valore non termina con il valore della condizione, ovvero controlla il suffisso, non il prefisso. I tipi FWP_BYTE_BLOB_TYPE (quando contiene una stringa) e FWP_UNICODE_STRING_TYPE supportano questo tipo di corrispondenza.
`FWP_MATCH_TYPE_MAX` Valore massimo a scopo di test. Non basarsi su questo valore nel codice, perché può cambiare quando si ricompila con un SDK più recente.

Commenti

In generale, il tipo di dati value e il tipo di dati della condizione di filtro devono essere uguali. Il motore di filtro di base (BFE) non esegue alcuna conversione dei dati. Ad esempio, non è possibile confrontare un valore FWP_UINT32 con un valore FWP_UINT16.

Le eccezioni a questa regola sono le seguenti.

È possibile confrontare un campo FWP_UINT32 che contiene un indirizzo IPv4 con un valore di FWP_V4_ADDR_MASK.
È possibile confrontare un campo FWP_BYTE_ARRAY16_TYPE che contiene un indirizzo IPv6 con un valore FWP_V6_ADDR_MASK.
È possibile confrontare un campo FWP_TOKEN_INFORMATION_TYPE con un valore FWP_SECURITY_DESCRIPTOR_TYPE quando si aggiungono filtri.
È possibile confrontare un campo FWP_TOKEN_ACCESS_INFORMATION_TYPE con un valore FWP_SECURITY_DESCRIPTOR_TYPE quando si aggiungono filtri.
È possibile confrontare un campo FWP_TOKEN_INFORMATION_TYPE con un valore FWP_SID durante l'enumerazione.
È possibile confrontare un campo FWP_TOKEN_ACCESS_INFORMATION_TYPE con un valore FWP_SID durante l'enumerazione.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	fwptypes.h

Vedi anche

Strutture API della piattaforma di filtro Windows

Condividi tramite