FWP_MATCH_TYPE-Enumeration (fwptypes.h)

Artikel
03/11/2023

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

Freigeben über