2.2.7 VARIANT Type Constants

The VARENUM enumeration constants are used in the discriminant field, vt, of the VARIANT type specified in section 2.2.29.2. When present, the VT_BYREF flag MUST be in an OR relation with another value to specify the byref argument for the VARIANT. The VT_EMPTY and VT_NULL values MUST NOT be specified with the VT_BYREF bit flag.

The following values are also used in the discriminant field, vt, of the TYPEDESC structure specified in section 2.2.37.

The meaning of each VARIANT type constant is specified as follows. The Context column specifies the context in which each constant is used. A constant MUST NOT be used in a VARIANT unless it is specified with a "V". A constant MUST NOT be used in a SAFEARRAY unless it is specified with an "S". A constant MUST NOT be used in a TYPEDESC unless it is specified with a "T".

 typedef  enum tagVARENUM
 {
   VT_EMPTY = 0x0000,
   VT_NULL = 0x0001,
   VT_I2 = 0x0002,
   VT_I4 = 0x0003,
   VT_R4 = 0x0004,
   VT_R8 = 0x0005,
   VT_CY = 0x0006,
   VT_DATE = 0x0007,
   VT_BSTR = 0x0008,
   VT_DISPATCH = 0x0009,
   VT_ERROR = 0x000A,
   VT_BOOL = 0x000B,
   VT_VARIANT = 0x000C,
   VT_UNKNOWN = 0x000D,
   VT_DECIMAL = 0x000E,
   VT_I1 = 0x0010,
   VT_UI1 = 0x0011,
   VT_UI2 = 0x0012,
   VT_UI4 = 0x0013,
   VT_I8 = 0x0014,
   VT_UI8 = 0x0015,
   VT_INT = 0x0016,
   VT_UINT = 0x0017,
   VT_VOID = 0x0018,
   VT_HRESULT = 0x0019,
   VT_PTR = 0x001A,
   VT_SAFEARRAY = 0x001B,
   VT_CARRAY = 0x001C,
   VT_USERDEFINED = 0x001D,
   VT_LPSTR = 0x001E,
   VT_LPWSTR = 0x001F,
   VT_RECORD = 0x0024,
   VT_INT_PTR = 0x0025,
   VT_UINT_PTR = 0x0026,
   VT_ARRAY = 0x2000,
   VT_BYREF = 0x4000
 } VARENUM;

VT_EMPTY: 

Context

Description

V

The type of the contained field is undefined. When this flag is specified, the VARIANT MUST NOT contain a data field. The VARIANT definition is specified in section 2.2.29.2.

VT_NULL: 

Context

Description

V

The type of the contained field is NULL. When this flag is specified, the VARIANT MUST NOT contain a data field. The VARIANT definition is specified in section 2.2.29.2.

VT_I2: 

Context

Description

V, S, T

Either the specified type, or the type of the element or contained field MUST be a 2-byte signed integer.

VT_I4: 

Context

Description

V, S, T

Either the specified type, or the type of the element or contained field MUST be a 4-byte signed integer.

VT_R4: 

Context

Description

V, S, T

Either the specified type, or the type of the element or contained field MUST be a 4-byte IEEE floating-point number.

VT_R8: 

Context

Description

V, S, T

Either the specified type, or the type of the element or contained field MUST be an 8-byte IEEE floating-point number.

VT_CY: 

Context

Description

V, S, T

Either the specified type, or the type of the element or contained field MUST be CURRENCY (see section 2.2.24).

VT_DATE: 

Context

Description

V, S, T

Either the specified type, or the type of the element or contained field MUST be DATE (see section 2.2.25).

VT_BSTR: 

Context

Description

V, S, T

Either the specified type, or the type of the element or contained field MUST be BSTR (see section 2.2.23).

VT_DISPATCH: 

Context

Description

V, S, T

Either the specified type, or the type of the element or contained field MUST be a pointer to IDispatch (see section 3.1.4).

VT_ERROR: 

Context

Description

V, S, T

Either the specified type, or the type of the element or contained field MUST be HRESULT.

VT_BOOL: 

Context

Description

V, S, T

Either the specified type, or the type of the element or contained field MUST be VARIANT_BOOL (see section 2.2.27).

VT_VARIANT: 

Context

Description

V, S, T

Either the specified type, or the type of the element or contained field MUST be VARIANT (see section 2.2.29). It MUST appear with the bit flag VT_BYREF.

VT_UNKNOWN: 

Context

Description

V, S, T

Either the specified type, or the type of the element or contained field MUST be a pointer to IUnknown.

VT_DECIMAL: 

Context

Description

V, S, T

Either the specified type, or the type of the element or contained field MUST be DECIMAL (see section 2.2.26).

VT_I1: 

Context

Description

V, S, T

Either the specified type, or the type of the element or contained field MUST be a 1-byte integer.

VT_UI1: 

Context

Description

V, S, T

Either the specified type, or the type of the element or contained field MUST be a 1-byte unsigned integer.

VT_UI2: 

Context

Description

V, S, T

Either the specified type, or the type of the element or contained field MUST be a 2-byte unsigned integer.

VT_UI4: 

Context

Description

V, S, T

Either the specified type, or the type of the element or contained field MUST be a 4-byte unsigned integer.

VT_I8: 

Context

Description

V, S, T

Either the specified type, or the type of the element or contained field MUST be an 8-byte signed integer.

VT_UI8: 

Context

Description

V, S, T

Either the specified type, or the type of the element or contained field MUST be an 8-byte unsigned integer.

VT_INT: 

Context

Description

V, S, T

Either the specified type, or the type of the element or contained field MUST be a 4-byte signed integer.

VT_UINT: 

Context

Description

V, S, T

Either the specified type, or the type of the element or contained field MUST be a 4-byte unsigned integer.

VT_VOID: 

Context

Description

T

The specified type MUST be void.

VT_HRESULT: 

Context

Description

T

The specified type MUST be HRESULT.

VT_PTR: 

Context

Description

T

The specified type MUST be a unique pointer, as specified in [C706] section 4.2.20.2.

VT_SAFEARRAY: 

Context

Description

T

The specified type MUST be SAFEARRAY (section 2.2.30).

VT_CARRAY: 

Context

Description

T

The specified type MUST be a fixed-size array.

VT_USERDEFINED: 

Context

Description

T

The specified type MUST be user defined.

VT_LPSTR: 

Context

Description

T

The specified type MUST be a NULL-terminated string, as specified in [C706] section 14.3.4.

VT_LPWSTR: 

Context

Description

T

The specified type MUST be a zero-terminated string of UNICODE characters, as specified in [C706], section 14.3.4.

VT_RECORD: 

Context

Description

V, S

The type of the element or contained field MUST be a BRECORD (see section 2.2.28.2).

VT_INT_PTR: 

Context

Description

T

The specified type MUST be either a 4-byte or an 8-byte signed integer. The size of the integer is platform specific and determines the system pointer size value, as specified in section 2.2.21.

VT_UINT_PTR: 

Context

Description

T

The specified type MUST be either a 4 byte or an 8 byte unsigned integer. The size of the integer is platform specific and determines the system pointer size value, as specified in section 2.2.21.

VT_ARRAY: 

Context

Description

V, S

The type of the element or contained field MUST be a SAFEARRAY (see section 2.2.30.10).

VT_BYREF: 

Context

Description

V, S

The type of the element or contained field MUST be a pointer to one of the types listed in the previous rows of this table. If present, this bit flag MUST appear in a VARIANT discriminant (see section 2.2.28) with one of the previous flags.