FWP_VALUE0 structure (fwptypes.h)

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

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 for this value.

See FWP_DATA_TYPE for more information.

uint8

case(FWP_UINT8)

An unsigned 8-bit integer.

uint16

case(FWP_UINT16)

An unsigned 16-bit integer.

uint32

case(FWP_UINT32)

An unsigned 32-bit integer.

uint64

case(FWP_UINT64)

A pointer to an unsigned 64-bit integer.

int8

case(FWP_INT8)

A signed 8-bit integer.

int16

case(FWP_INT16)

A signed 16-bit integer.

int32

case(FWP_INT32)

A signed 32-bit integer.

int64

case(FWP_INT64)

A pointer to a signed 64-bit integer.

float32

case(FWP_FLOAT)

A single-precision floating-point value.

double64

case(FWP_DOUBLE)

A pointer to a double-precision floating-point value.

byteArray16

case(FWP_BYTE_ARRAY16_TYPE)

A pointer to a FWP_BYTE_ARRAY16 structure.

byteBlob

case(FWP_BYTE_BLOB_TYPE)

A pointer to a FWP_BYTE_BLOB structure.

sid

case(FWP_SID)

A pointer to a SID.

sd

case(FWP_SECURITY_DESCRIPTOR_TYPE)

A pointer to a security descriptor contained in a FWP_BYTE_BLOB structure. The data contained in the blob is a SECURITY_DESCRIPTOR structure.

tokenInformation

case(FWP_TOKEN_INFORMATION_TYPE)

A pointer to an FWP_TOKEN_INFORMATION structure.

tokenAccessInformation

case(FWP_TOKEN_ACCESS_INFORMATION_TYPE)

A pointer to token access information contained in a FWP_BYTE_BLOB structure. The data contained in the blob is a TOKEN_ACCESS_INFORMATION structure.

unicodeString

case(FWP_UNICODE_STRING_TYPE)

A pointer to a null-terminated unicode string.

byteArray6

case(FWP_BYTE_ARRAY6_TYPE)

Reserved.

Remarks

For the unnamed union, switch_type(FWP_DATA_TYPE), switch_is(type).

This is primarily used to supply incoming values to the filter engine.

When IP addresses are stored in FWP_UINT32 format or when IP port is stored in FWP_UINT16 format, they are stored in host-order not network-order.

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

Requirements

   
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header fwptypes.h

See also

FWP_BYTE_ARRAY16

FWP_BYTE_BLOB

FWP_DATA_TYPE

Windows Filtering Platform API structures