Share via


MAPINAMEID

The MAPINAMEID structure is used to describe a named property.

Syntax

typedef struct _MAPINAMEID 
{ 
   LPGUID lpguid; 
   ULONG ulKind; 
   union 
   { 
     LONG  lID; 
     LPWSTR lpwstrName; 
   } Kind; 
} MAPINAMEID, FAR *LPMAPINAMEID; 

Members

  • 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:

    MNID_ID

    Not supported.

    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 be either an integer value, stored in lID, or a Unicode character string, stored in lpwstrName.

Remarks

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.

Requirements

Pocket PC: Windows Mobile 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.

© 2005 Microsoft Corporation. All rights reserved.