Send Feedback

The MAPINAMEID structure is used to describe a named property.


struct {
   LPGUID lpguid;
   ULONG ulKind;
     LONG  lID;
     LPWSTR lpwstrName;
   } Kind;


  • lpguid
    Pointer to a GUID structure defining a particular property set; cannot be NULL. The only valid value is PS_MAPI.

  • ulKind
    Value describing the type of value in the Kind member. Valid values are as follows:


    Not supported.


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

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


The MAPINAMEID structure is used to describe named properties — properties that have identifiers over 0x8000. A property set is an integral part of a named property.

Named properties enable clients to define custom properties in a larger name space than is available in the MAPI-defined property identifier range. Property names cannot be used to obtain property values directly; they must first be mapped to property identifiers through the IMAPIProp::GetIDsFromNames method. For particular objects, such as message objects, MAPI reserves a range of property identifiers for custom properties. For these objects, clients need not use named properties and can save the associated overhead.


Pocket PC: Pocket PC 2002 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: mapidefs.h

See Also

GUID | IMAPIProp::GetIDsFromNames | MAPI Structures | Messaging

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.