FWP_CONDITION_VALUE0 结构 (fwptypes.h)

项目
02/29/2024

FWP_CONDITION_VALUE0 结构包含在测试匹配筛选器时筛选器条件中使用的值。

语法

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;

成员

type

指定条件值的数据类型。

有关详细信息，请参阅FWP_DATA_TYPE 。

uint8

当类型为 FWP_UINT8 时可用。

8 位无符号整数。

uint16

当类型为 FWP_UINT16 时可用。

16 位无符号整数。

uint32

当类型为 FWP_UINT32 时可用。

32 位无符号整数。

uint64

当类型为 FWP_UINT64 时可用。

指向无符号 64 位整数的指针。

注意

此值不能为 null。

int8

当类型为 FWP_INT8 时可用。

一个有符号的 8 位整数。

int16

当类型为 FWP_INT16 时可用。

16 位有符号整数。

int32

当类型为 FWP_INT32 时可用。

16 位有符号整数。

int64

当类型为 FWP_INT64 时可用。

指向有符号 64 位整数的指针。

注意

此值不能为 null。

float32

当类型为 FWP_FLOAT 时可用。

单精度浮点值。

double64

当类型为 FWP_DOUBLE 时可用。

指向双精度浮点值的指针。

注意

此值不能为 null。

byteArray16

当类型为 FWP_BYTE_ARRAY16_TYPE 时可用。

指向 FWP_BYTE_ARRAY16 结构的指针。

注意

此值不能为 null。

byteBlob

当类型为 FWP_BYTE_BLOB_TYPE 时可用。

指向 FWP_BYTE_BLOB 结构的指针。

注意

FWP_BYTE_BLOB 结构不能为 null。

sid

当类型为 FWP_SID 时可用。

指向 SID) 结构 (安全标识符的指针。

注意

此安全标识符不能为 null。

sd

当类型为 FWP_SECURITY_DESCRIPTOR_TYPE 时可用。

指向包含在 FWP_BYTE_BLOB 结构中的安全描述符的指针。

注意

在筛选条件中使用时，安全描述符不能为 null。此外，它们需要采用自相对格式。

tokenInformation

当类型为 FWP_TOKEN_INFORMATION_TYPE 时可用。

指向包含在 FWP_TOKEN_INFORMATION 结构中的标记信息的指针。

tokenAccessInformation

当类型为 FWP_TOKEN_ACCESS_INFORMATION_TYPE 时可用。

指向 FWP_BYTE_BLOB 结构中包含的令牌访问信息的指针。

注意

FWP_BYTE_BLOB 结构不能为 null。

unicodeString

当类型为 FWP_UNICODE_STRING_TYPE 时可用。

指向以 null 结尾的 unicode 字符串的指针。

注意

此值不能为 null。

byteArray6

当类型为 FWP_BYTE_ARRAY6_TYPE 时可用。

指向 FWP_BYTE_ARRAY6 结构的指针。

注意

此值不能为 null。

注意

仅在 Windows 7 和 Windows Server 2008 R2 中可用。

v4AddrMask

当类型为 FWP_V4_ADDR_MASK 时可用。

指向 FWP_V4_ADDR_AND_MASK 结构中包含的 IPv4 地址的指针。

v6AddrMask

当类型为 FWP_V6_ADDR_MASK 时可用。

指向包含在FWP_V6_ADDR_AND_MASK 结构中的 IPv6 地址的指针。

rangeValue

当类型为 FWP_RANGE_TYPE 时可用。

指向 FWP_RANGE0 结构中包含的区域的指针。

注解

FWP_CONDITION_VALUE0 的数据类型必须与要与之进行比较的FWP_VALUE0的数据类型兼容。但是，这并不意味着数据类型必须相同。例如，可以将FWP_V4_ADDR_MASK与包含 IPv4 地址的FWP_UINT32进行比较。有关FWP_CONDITION_VALUE0和FWP_VALUE0兼容性规则的详细信息，请参阅FWP_MATCH_TYPE。

FWP_CONDITION_VALUE0 是FWP_CONDITION_VALUE的特定实现。有关详细信息，请参阅 WFP Version-Independent 名称和面向特定版本的 Windows 。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	fwptypes.h