MAPINAMEID

Send Feedback

The MAPINAMEID structure is used to describe a named property.

Syntax

struct {
   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: 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.