FWP_CONDITION_VALUE0 structure (fwptypes.h)
The FWP_CONDITION_VALUE0 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_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;
Members
type
Specifies the data type of the condition value.
See 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
FWP_BYTE_BLOB structure cannot be null.
sid
Available when type is FWP_SID.
A pointer to a security identifier (SID) structure.
Note
This 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_TOKEN_INFORMATION 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
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.
byteArray6
Available when type is FWP_BYTE_ARRAY6_TYPE.
A pointer to a FWP_BYTE_ARRAY6 structure.
Note
This value cannot be null.
Note
Available only in Windows 7 and Windows Server 2008 R2.
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 FWP_MATCH_TYPE for detailed information about FWP_CONDITION_VALUE0 and FWP_VALUE0 compatibility rules.
FWP_CONDITION_VALUE0 is a specific implementation of FWP_CONDITION_VALUE. See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Header | fwptypes.h |
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for