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
Send feedback on this topic to the authors.
© 2005 Microsoft Corporation. All rights reserved.