FWP_CONDITION_VALUE0-Struktur (fwptypes.h)

Artikel
08/23/2023

Die FWP_CONDITION_VALUE0-Struktur enthält Werte, die unter Filterbedingungen beim Testen auf übereinstimmende Filter verwendet werden.

Syntax

typedef struct FWP_CONDITION_VALUE0_ {
  FWP_DATA_TYPE type;
  union {
    UINT8                 uint8;
    UINT16                uint16;
    UINT32                uint32;
    UINT64                *uint64;
    INT8                  int8;
    INT16                 int16;
    INT32                 int32;
    INT64                 *int64;
    float                 float32;
    double                *double64;
    FWP_BYTE_ARRAY16      *byteArray16;
    FWP_BYTE_BLOB         *byteBlob;
    SID                   *sid;
    FWP_BYTE_BLOB         *sd;
    FWP_TOKEN_INFORMATION *tokenInformation;
    FWP_BYTE_BLOB         *tokenAccessInformation;
    LPWSTR                unicodeString;
    FWP_BYTE_ARRAY6       *byteArray6;
    FWP_V4_ADDR_AND_MASK  *v4AddrMask;
    FWP_V6_ADDR_AND_MASK  *v6AddrMask;
    FWP_RANGE0            *rangeValue;
  };
} FWP_CONDITION_VALUE0;

Member

type

Gibt den Datentyp des Bedingungswerts an.

Weitere Informationen finden Sie unter FWP_DATA_TYPE .

uint8

Verfügbar, wenn der Typ FWP_UINT8 ist.

Eine 8-Bit-Ganzzahl ohne Vorzeichen.

uint16

Verfügbar, wenn der Typ FWP_UINT16 ist.

Eine 16-Bit-Ganzzahl ohne Vorzeichen.

uint32

Verfügbar, wenn der Typ FWP_UINT32 ist.

Eine 32-Bit-Ganzzahl ohne Vorzeichen.

uint64

Verfügbar, wenn der Typ FWP_UINT64 ist.

Ein Zeiger auf eine ganzzahlige 64-Bit-Zahl ohne Vorzeichen.

Hinweis

Dieser Wert darf nicht NULL sein.

int8

Verfügbar, wenn der Typ FWP_INT8 ist.

Eine ganze 8-Bit-Zahl mit Vorzeichen.

int16

Verfügbar, wenn der Typ FWP_INT16 ist.

Eine ganze 16-Bit-Zahl mit Vorzeichen.

int32

Verfügbar, wenn der Typ FWP_INT32 ist.

Eine 32-Bit-Ganzzahl mit Vorzeichen.

int64

Verfügbar, wenn der Typ FWP_INT64 ist.

Ein Zeiger auf eine ganze 64-Bit-Zahl mit Vorzeichen.

Hinweis

Dieser Wert darf nicht NULL sein.

float32

Verfügbar, wenn der Typ FWP_FLOAT ist.

Ein Gleitkommawert mit einfacher Genauigkeit.

double64

Verfügbar, wenn der Typ FWP_DOUBLE ist.

Ein Zeiger auf einen Gleitkommawert mit doppelter Genauigkeit.

Hinweis

Dieser Wert darf nicht NULL sein.

byteArray16

Verfügbar, wenn der Typ FWP_BYTE_ARRAY16_TYPE ist.

Ein Zeiger auf eine FWP_BYTE_ARRAY16-Struktur .

Hinweis

Dieser Wert darf nicht NULL sein.

byteBlob

Verfügbar, wenn der Typ FWP_BYTE_BLOB_TYPE ist.

Ein Zeiger auf eine FWP_BYTE_BLOB Struktur.

Hinweis

FWP_BYTE_BLOB Struktur darf nicht NULL sein.

sid

Verfügbar, wenn der Typ FWP_SID ist.

Ein Zeiger auf eine Sid-Struktur (Security Identifier).

Hinweis

Dieser Sicherheitsbezeichner darf nicht NULL sein.

sd

Verfügbar, wenn der Typ FWP_SECURITY_DESCRIPTOR_TYPE ist.

Ein Zeiger auf eine Sicherheitsbeschreibung, die in einer FWP_BYTE_BLOB-Struktur enthalten ist.

Hinweis

Sicherheitsdeskriptoren können nicht NULL sein, wenn sie unter Filterbedingungen verwendet werden. Darüber hinaus müssen sie in einem selbstrelativen Format vorliegen.

tokenInformation

Verfügbar, wenn der Typ FWP_TOKEN_INFORMATION_TYPE ist.

Ein Zeiger auf Tokeninformationen, die in einer FWP_TOKEN_INFORMATION-Struktur enthalten sind.

tokenAccessInformation

Verfügbar, wenn der Typ FWP_TOKEN_ACCESS_INFORMATION_TYPE ist.

Ein Zeiger auf Tokenzugriffsinformationen, die in einer FWP_BYTE_BLOB-Struktur enthalten sind.

Hinweis

FWP_BYTE_BLOB Struktur darf nicht NULL sein.

unicodeString

Verfügbar, wenn der Typ FWP_UNICODE_STRING_TYPE ist.

Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung.

Hinweis

Dieser Wert darf nicht NULL sein.

byteArray6

Verfügbar, wenn der Typ FWP_BYTE_ARRAY6_TYPE ist.

Ein Zeiger auf eine FWP_BYTE_ARRAY6-Struktur .

Hinweis

Dieser Wert darf nicht NULL sein.

Hinweis

Nur in Windows 7 und Windows Server 2008 R2 verfügbar.

v4AddrMask

Verfügbar, wenn der Typ FWP_V4_ADDR_MASK ist.

Ein Zeiger auf eine IPv4-Adresse, die in einer FWP_V4_ADDR_AND_MASK-Struktur enthalten ist.

v6AddrMask

Verfügbar, wenn der Typ FWP_V6_ADDR_MASK ist.

Ein Zeiger auf eine IPv6-Adresse, die in einer FWP_V6_ADDR_AND_MASK-Struktur enthalten ist.

rangeValue

Verfügbar, wenn der Typ FWP_RANGE_TYPE ist.

Ein Zeiger auf einen Bereich, der in einer FWP_RANGE0-Struktur enthalten ist.

Hinweise

Der Datentyp von FWP_CONDITION_VALUE0 muss mit dem Datentyp des FWP_VALUE0 kompatibel sein, mit dem er verglichen wird. Dies bedeutet jedoch nicht, dass die Datentypen notwendigerweise identisch sein müssen. Ein FWP_V4_ADDR_MASK kann beispielsweise mit einer FWP_UINT32 verglichen werden, die eine IPv4-Adresse enthält. Ausführliche Informationen zu FWP_CONDITION_VALUE0 und FWP_VALUE0 Kompatibilitätsregeln finden Sie unter FWP_MATCH_TYPE.

FWP_CONDITION_VALUE0 ist eine spezifische Implementierung von FWP_CONDITION_VALUE. Weitere Informationen finden Sie unter WFP Version-Independent Namen und Zielgruppenspezifische Windows-Versionen .

Anforderungen

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