MAPINAMEID
Область применения: Outlook 2013 | Outlook 2016
Описывает именованное свойство.
| Свойство | Значение |
|---|---|
| Файл заголовка: |
Mapidefs.h |
typedef struct _MAPINAMEID
{
LPGUID lpguid;
ULONG ulKind;
union
{
LONG lID;
LPWSTR lpwstrName;
} Kind;
} MAPINAMEID, FAR *LPMAPINAMEID;
Members
lpguid
Указатель на структуру GUID , определяющую определенный набор свойств; этот элемент не может иметь значение NULL. Допустимы следующие значения:
PS_PUBLIC_STRINGS
PS_MAPI
Определяемое клиентом значение
ulKind
Значение, описывающее тип значения в элементе Kind . Допустимы следующие значения:
MNID_ID
Элемент Kind содержит целочисленное значение, представляющее имя свойства.
MNID_STRING
Элемент Kind содержит символьную строку Юникода, представляющую имя свойства.
Kind
Объединение, описывающее имя именованного свойства. Имя может быть целым числом, хранящимся в lID, или строкой символов Юникода, хранящейся в lpwstrName.
Замечания
Структура MAPINAMEID используется для описания свойств именованных свойств, которые имеют идентификаторы 0x8000. Набор свойств является важной частью именованного свойства. Например, PS_PUBLIC_STRINGS или PS_ROUTING_ADDRTYPE — это наборы свойств, определенные MAPI.
Именованные свойства позволяют клиентам определять пользовательские свойства в большем пространстве имен, чем доступно в диапазоне идентификаторов свойств, определяемом MAPI. Имена свойств нельзя использовать для получения значений свойств напрямую; Сначала они должны быть сопоставлены с идентификаторами свойств с помощью метода IMAPIProp::GetIDsFromNames . Для определенных объектов, таких как сообщения, MAPI резервирует диапазон идентификаторов свойств для пользовательских свойств. Таким образом, для этих объектов клиентам не требуется использовать именованные свойства и они могут сэкономить связанные с ними издержки.
Дополнительные сведения об именованных свойствах см. в разделе Именованные свойства.