FWP_MATCH_TYPE-Enumeration (fwptypes.h)

  • Artikel

Der FWP_MATCH_TYPE aufgezählten Typ gibt verschiedene Übereinstimmungstypen an, die in Filterbedingungen zulässig sind.

Syntax

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;

Konstanten

 
FWP_MATCH_EQUAL
Wert: 0
Testet, ob der Wert dem Bedingungswert entspricht.

Alle Datentypen unterstützen FWP_MATCH_EQUAL.
FWP_MATCH_GREATER
Testet, ob der Wert größer als der Bedingungswert ist.

Nur sortierbare Datentypen unterstützen FWP_MATCH_GREATER. Sortierbare Datentypen bestehen aus allen Ganzzahltypen, FWP_BYTE_ARRAY16_TYPE, FWP_BYTE_BLOB_TYPE und FWP_UNICODE_STRING_TYPE.
FWP_MATCH_LESS
Testet, ob der Wert kleiner als der Bedingungswert ist.

Nur sortierbare Datentypen unterstützen FWP_MATCH_LESS.
FWP_MATCH_GREATER_OR_EQUAL
Testet, ob der Wert größer oder gleich dem Bedingungswert ist.

Nur sortierbare Datentypen unterstützen FWP_MATCH_GREATER_OR_EQUAL.
FWP_MATCH_LESS_OR_EQUAL
Testet, ob der Wert kleiner oder gleich dem Bedingungswert ist.

Nur sortierbare Datentypen unterstützen FWP_MATCH_LESS_OR_EQUAL.
FWP_MATCH_RANGE
Testet, ob der Wert innerhalb eines bestimmten Bereichs von Bedingungswerten liegt.

Nur sortierbare Datentypen unterstützen FWP_MATCH_RANGE.
FWP_MATCH_FLAGS_ALL_SET
Testet, ob alle Flags festgelegt sind.

Nur ganzzahlige Datentypen ohne Vorzeichen unterstützen FWP_MATCH_FLAGS_ALL_SET.
FWP_MATCH_FLAGS_ANY_SET
Testet, ob Flags festgelegt sind.

Nur ganzzahlige Datentypen ohne Vorzeichen unterstützen FWP_MATCH_FLAGS_ANY_SET.
FWP_MATCH_FLAGS_NONE_SET
Testet, ob keine Flags festgelegt sind.

Nur ganzzahlige Datentypen ohne Vorzeichen unterstützen FWP_MATCH_FLAGS_NONE_SET.
FWP_MATCH_EQUAL_CASE_INSENSITIVE
Testet, ob der Wert dem Bedingungswert entspricht. Bei diesem Test wird die Groß-/Kleinschreibung nicht beachtet.

Nur der Datentyp FWP_UNICODE_STRING_TYPE unterstützt FWP_MATCH_EQUAL_CASE_INSENSITIVE.
FWP_MATCH_NOT_EQUAL
Testet, ob der Wert nicht gleich dem Bedingungswert ist.

Nur sortierbare Datentypen unterstützen FWP_MATCH_NOT_EQUAL.
Hinweis Nur in Windows 7 und Windows Server 2008 R2 verfügbar.

 
FWP_MATCH_PREFIX
Dieses Flag hat einen irreführenden Namen. Es wird getestet, ob der Wert mit dem Bedingungswert endet , d. h. mit dem Suffix, nicht mit dem Präfix.

Die Typen FWP_BYTE_BLOB_TYPE (wenn sie eine Zeichenfolge enthält) und FWP_UNICODE_STRING_TYPE unterstützen diesen Übereinstimmungstyp.
FWP_MATCH_NOT_PREFIX
Dieses Flag hat einen irreführenden Namen. Er testet, ob der Wert nicht mit dem Bedingungswert endet , d. h. er überprüft das Suffix, nicht das Präfix.

Die Typen FWP_BYTE_BLOB_TYPE (wenn sie eine Zeichenfolge enthält) und FWP_UNICODE_STRING_TYPE unterstützen diesen Übereinstimmungstyp.
FWP_MATCH_TYPE_MAX
Maximalwert für Testzwecke. Verlassen Sie sich nicht im Code auf diesen Wert, da er sich ändern kann, wenn Sie ein neueres SDK kompilieren.

Bemerkungen

Im Allgemeinen müssen der Wertdatentyp und der Datentyp der Filterbedingung identisch sein. Die Basisfilterungs-Engine (BFE) führt keine Datenkonvertierung aus. Beispielsweise kann ein FWP_UINT32-Wert nicht mit einem FWP_UINT16-Wert verglichen werden.

Ausnahmen von dieser Regel sind die folgenden.

  • Ein FWP_UINT32 Feld, das eine IPv4-Adresse enthält, kann mit einem FWP_V4_ADDR_MASK-Wert verglichen werden.
  • Ein FWP_BYTE_ARRAY16_TYPE Feld, das eine IPv6-Adresse enthält, kann mit einem FWP_V6_ADDR_MASK-Wert verglichen werden.
  • Ein FWP_TOKEN_INFORMATION_TYPE Feld kann beim Hinzufügen von Filtern mit einem FWP_SECURITY_DESCRIPTOR_TYPE-Wert verglichen werden.
  • Ein FWP_TOKEN_ACCESS_INFORMATION_TYPE Feld kann beim Hinzufügen von Filtern mit einem FWP_SECURITY_DESCRIPTOR_TYPE-Wert verglichen werden.
  • Ein FWP_TOKEN_INFORMATION_TYPE Feld kann beim Aufzählen mit einem FWP_SID-Wert verglichen werden.
  • Ein FWP_TOKEN_ACCESS_INFORMATION_TYPE Feld kann beim Aufzählen mit einem FWP_SID-Wert verglichen werden.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile fwptypes.h

Weitere Informationen

API-Strukturen der Windows-Filterplattform