FWP_VALUE0 structure

The FWP_VALUE0 structure defines a data value that can be one of a number of different data types.

Note  FWP_VALUE0 is a specific version of FWP_VALUE. See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information.
 

Syntax


typedef struct FWP_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_VALUE0;

Members

type

The type of data that is described by the structure. For possible choices for this data member, see FWP_DATA_TYPE.

uint8

An unsigned 8-bit value. Used when the Type member is set to FWP_UINT8.

uint16

An unsigned 16-bit value. Used when the Type member is set to FWP_UINT16.

uint32

An unsigned 32-bit value. Used when the Type member is set to FWP_UINT32.

uint64

A pointer to an unsigned 64-bit value. Used when the Type member is set to FWP_UINT64.

int8

A signed 8-bit value. Used when the Type member is set to FWP_UINT8.

int16

A signed 16-bit value. Used when the Type member is set to FWP_UINT16.

int32

A signed 32-bit value. Used when the Type member is set to FWP_UINT32.

int64

A pointer to a signed 64-bit value. Used when the Type member is set to FWP_UINT64.

float32

A single-precision floating-point value. Used when the Type member is set to FWP_FLOAT.

double64

A pointer to a double-precision floating-point value. Used when the Type member is set to FWP_DOUBLE.

byteArray16

A pointer to an FWP_BYTE_ARRAY16 structure. Used when the Type member is set to FWP_BYTE_ARRAY16_TYPE.

byteBlob

A pointer to an FWP_BYTE_BLOB structure. Used when the Type member is set to FWP_BYTE_BLOB_TYPE.

sid

A pointer to a security identifier (SID) structure. Used when the Type member is set to FWP_SID. For more information about the SID structure, see the description for the SID structure in the Microsoft Windows SDK documentation.

sd

A pointer to an FWP_BYTE_BLOB structure that describes a security descriptor. Used when the Type member is set to FWP_SECURITY_DESCRIPTOR_TYPE. The data contained in the blob is a SECURITY_DESCRIPTOR structure.

tokenInformation

A pointer to an FWP_TOKEN_INFORMATION structure. Used when the Type member is set to FWP_TOKEN_INFORMATION_TYPE.

tokenAccessInformation

A pointer to an FWP_BYTE_BLOB structure that describes token access information. Used when the Type member is set to FWP_TOKEN_ACCESS_INFORMATION_TYPE. The data contained in the blob is a TOKEN_ACCESS_INFORMATION structure.

unicodeString

A pointer to a null-terminated string of Unicode characters. Used when the Type member is set to FWP_UNICODE_STRING_TYPE.

byteArray6

A pointer to an FWP_BYTE_ARRAY6 structure. Used when the Type member is set to FWP_BYTE_ARRAY6_TYPE.

Remarks

The FWP_VALUE0 structure specifies a value that can be one of a number of different data types. This structure is used to:

  • Specify the endpoints of a range of values.

  • Specify the weight of a filter.

  • Specify the incoming data values and metadata values that are passed to a callout's classifyFn callout function.

Requirements

Version

Available starting with Windows Vista.

Header

Fwptypes.h (include Fwpsk.h)

See also

FWP_BYTE_ARRAY16
FWP_BYTE_ARRAY6
FWP_BYTE_BLOB
FWP_DATA_TYPE
FWP_RANGE0
FWP_TOKEN_INFORMATION
FWPS_FILTER0
FWPS_INCOMING_VALUE0

 

 

Send comments about this topic to Microsoft

Show: