SPropValue

Describes a MAPI property.

Header file:	Mapidefs.h
Related macros:	, , , ,

C++

typedef struct _SPropValue
{
  ULONG ulPropTag;
  ULONG dwAlignPad;
  union _PV Value;
} SPropValue, FAR *LPSPropValue;

 Members

ulPropTag

Property tag for the property. Property tags are 32-bit unsigned integers consisting of the property's unique identifier in the high-order 16 bits and the property's type in the low-order 16 bits.

dwAlignPad

Reserved for MAPI; do not use.

Value

Union of data values, the specific value dictated by the property type. The following table lists for each property type, the member of the union that should be used and its associated data type.

Property type	Value	Data type of Value
PT_I2 or PT_SHORT	i	short int
PT_I4 or PT_LONG (signed)	l	LONG
PT_I4 or PT_LONG (unsigned)	ul	ULONG
PT_R4 or PT_FLOAT	flt	float
PT_R8 or PT_DOUBLE	dbl	double
PT_BOOLEAN	b	unsigned short int
PT_CURRENCY	cur
PT_APPTIME	at	double
PT_SYSTIME	ft
PT_STRING8	lpszA	LPSTR
PT_BINARY	bin	BYTE [array]
PT_UNICODE	lpszW	LPWSTR
PT_CLSID	lpguid	LPGUID
PT_I8 or PT_LONGLONG	li	LARGE_INTEGER
PT_MV_I2	MVi
PT_MV_LONG	MVI
PT_MV_R4	MVflt
PT_MV_DOUBLE	MVdbl
PT_MV_CURRENCY	MVcur
PT_MV_APPTIME	MVat
PT_MV_SYSTIME	MVft
PT_MV_BINARY	MVbin
PT_MV_STRING8	MVszA
PT_MV_UNICODE	MVszW
PT_MV_CLSID	MVguid
PT_MV_I8	MVli
PT_ERROR	err
PT_NULL or PT_OBJECT	x	LONG

 Remarks

The ulPropTag member is made up of two parts:

• An identifier in the high-order 16 bits.

• A type in the low-order 16 bits.

The identifier is a numeric value within a particular range. MAPI defines ranges for identifiers to describe what the property is used for and who is responsible for maintaining it. MAPI defines constraints for each of the property tags that it supports in the Mapitags.h header file.

The type indicates the format for the property's value. MAPI defines constants for each of the property types that it supports in the Mapidefs.h header file.

For a complete list of the valid property ranges for identifiers and property types, see the appendix.

The dwAlignPad member is used as padding to make sure proper alignment on computers that require 8-byte alignment for 8-byte values. Developers who write code on such computers should use memory allocation routines that allocate the SPropValue arrays on 8-byte boundaries.

For more information, see and .