enumerazione FWP_MATCH_TYPE (fwptypes.h)

  • Articolo

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