MAPINAMEID 

The MAPINAMEID structure is used to describe a named property.

Quick Info

typedef struct _MAPINAMEID

{ 

     LPGUID lpguid;

     ULONG  ulKind;

     union

     { 

          LONG    lID;

          LPWSTR  lpwstrName;

     } Kind;

} MAPINAMEID, FAR *LPMAPINAMEID;

Members

lpguid

Pointer to a GUID14AUUS3 structure defining a particular property set; this member cannot be NULL. Valid values are PS_PUBLIC_STRINGS, PS_MAPI, or a client-defined value.

ulKind

Value describing the type of value in the Kind member. Valid values are:

MNID_ID

The Kind member contains an integer value representing the property name.

MNID_STRING

The Kind member contains a Unicode character string representing the property name.

Kind

Union describing the name of the named property. The name can either be an integer value, stored in lID, or a Unicode character string, stored in lpwstrName.

Remarks

The MAPINAMEID structure is used to describe the names of named properties   properties that have identifiers over 0x8000. A property set is an integral part of a named property's property name. For example PS_PUBLIC_STRINGS or PS_ROUTING_ADDRTYPE are property sets defined by MAPI.

Property names enable users to define custom properties in a larger name space than the MAPI property identifier. Property names cannot be used to obtain property values directly; they must first be mapped to property identifiers through the IMAPIProp::GetIDsFromNames method.

For more information about named properties, see Named PropertiesVDUZP5.

See Also