Compartilhar via


FWP_CONDITION_VALUE0 (Compact 2013)

3/26/2014

This structure contains values that are used in filter conditions when testing for matching filters.

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_BYTE_BLOB* tokenInformation;
    FWP_BYTE_BLOB* tokenAccessInformation;
    LPWSTR unicodeString;
    FWP_V4_ADDR_AND_MASK* v4AddrMask;
    FWP_V6_ADDR_AND_MASK* v6AddrMask;
    FWP_RANGE0* rangeValue;
  };
} FWP_CONDITION_VALUE0;

Members

  • type
    Specifies the data type of the condition value.

    See topic FWP_DATA_TYPE for more information.

  • uint8
    Available when type is FWP_UINT8.

    An unsigned 8-bit integer.

  • uint16
    Available when type is FWP_UINT16.

    An unsigned 16-bit integer.

  • uint32
    Available when type is FWP_UINT32.

    An unsigned 32-bit integer.

  • uint64
    Available when type is FWP_UINT64.

    A pointer to an unsigned 64-bit integer.

    Note

    This value cannot be null.

  • int8
    Available when type is FWP_INT8.

    A signed 8-bit integer.

  • int16
    Available when type is FWP_INT16.

    A signed 16-bit integer.

  • int32
    Available when type is FWP_INT32.

    A signed 32-bit integer.

  • int64
    Available when type is FWP_INT64.

    A pointer to a signed 64-bit integer.

    Note

    This value cannot be null.

  • float32
    Available when type is FWP_FLOAT.

    A single-precision floating point value.

  • double64
    Available when type is FWP_DOUBLE.

    A pointer to a double-precision floating point value.

    Note

    This value cannot be null.

  • byteArray16
    Available when type is FWP_BYTE_ARRAY16_TYPE.

    A pointer to a FWP_BYTE_ARRAY16 structure.

    Note

    This value cannot be null.

  • byteBlob
    Available when type is FWP_BYTE_BLOB_TYPE.

    A pointer to a FWP_BYTE_BLOB structure.

    Note

    The FWP_BYTE_BLOB structure cannot be null.

  • sid
    Available when type is FWP_SID.

    A pointer to a security identifier (SID) structure.

    Note

    The security identifier cannot be null.

  • sd
    Available when type is FWP_SECURITY_DESCRIPTOR_TYPE.

    A pointer to a security descriptor contained in a FWP_BYTE_BLOB structure.

    Note

    Security descriptors cannot be null when used in filter conditions. Moreover, they need to be in self-relative format.

  • tokenInformation
    Available when type is FWP_TOKEN_INFORMATION_TYPE.

    A pointer to token information contained in a FWP_BYTE_BLOB structure.

  • tokenAccessInformation
    Available when type is FWP_TOKEN_ACCESS_INFORMATION_TYPE.

    A pointer to token access information contained in a FWP_BYTE_BLOB structure.

    Note

    The FWP_BYTE_BLOB structure cannot be null.

  • unicodeString
    Available when type is FWP_UNICODE_STRING_TYPE.

    A pointer to a null-terminated unicode string.

    Note

    This value cannot be null.

  • v4AddrMask
    Available when type is FWP_V4_ADDR_MASK.

    A pointer to an IPv4 address contained in an FWP_V4_ADDR_AND_MASK structure.

  • v6AddrMask
    Available when type is FWP_V6_ADDR_MASK.

    A pointer to an IPv6 address contained in an FWP_V6_ADDR_AND_MASK structure.

  • rangeValue
    Available when type is FWP_RANGE_TYPE.

    A pointer to a range contained in an FWP_RANGE0 structure.

Remarks

The data type of FWP_CONDITION_VALUE0 must be compatible with the data type of the FWP_VALUE0 to which it is being compared. However, this does not mean the data types necessarily need to be the same. For example, an FWP_V4_ADDR_MASK can be compared to an FWP_UINT32 containing an IPv4 address. See topic FWP_MATCH_TYPE for detailed information about FWP_CONDITION_VALUE0 and FWP_VALUE0 compatibility rules.

Requirements

Header

fwpmu.h

See Also

Reference

WFP Shared Structures

Other Resources

Windows Filtering Platform