Обзор свойств MAPI
Область применения: Outlook 2013 | Outlook 2016
Свойство является атрибутом объекта MAPI. Свойства описывают что-то об объекте, например строку темы сообщения или тип адреса пользователя обмена сообщениями. MAPI определяет множество свойств, некоторые из которых описывают множество объектов, а некоторые из них подходят только для объекта определенного типа. Клиенты и поставщики услуг могут расширить набор предопределенных свойств MAPI, создавая новые настраиваемые свойства. Клиенты могут определять свойства для описания новых классов сообщений, а поставщики услуг могут определять свойства для предоставления уникальных функций своей системы обмена сообщениями.
Свойства могут быть постоянными или временными. Свойства, сохраняющиеся из сеанса в сеанс, могут храниться вместе с данными своих объектов или в профиле. Временные свойства существуют только в течение текущего сеанса.
Клиенты и поставщики услуг могут показывать свойства пользователям с таблицей или листом свойств. Таблицы предоставляют пользователям доступное только для чтения представление некоторых свойств, принадлежащих нескольким объектам. Данные отображаются в формате строк и столбцов, при этом каждая строка представляет объект, а каждый столбец — свойство. Листы свойств — это диалоговые окна с вкладками, в которых отображаются связанные свойства для одного объекта. Листы свойств могут предоставлять доступ только для чтения или чтения и записи к данным. Указывает, разрешено ли пользователю вносить изменения, определяется реализацией страницы свойств.
Интерфейс IMAPIProp является основным интерфейсом для работы со свойствами. Все объекты, поддерживающие свойства, реализуют IMAPIProp. IMAPIProp включает методы для получения значений свойств, копирования свойств, внесения изменений и сохранения этих изменений, сопоставления имен свойств и их идентификаторов, а также получения сведений о предыдущей ошибке.
Существует несколько структур данных для описания свойств и сведений о свойствах. Чаще всего используются структуры SPropValue и SPropTagArray . Структура SPropValue содержит три элемента информации, описывающие свойство:
Данные или значение свойства.
Тип данных значения свойства, например целочисленное или логическое значение.
Числовое значение в пределах определенного диапазона, однозначно определяющее свойство и компонент, отвечающие за его обслуживание. Например, существует диапазон для хранения свойств содержимого сообщения, определенных MAPI, и другой диапазон для хранения свойств содержимого сообщения, определенных клиентом для пользовательского класса сообщений.
Тип свойства и идентификатор объединяются в один компонент, называемый тегом свойства. Теги свойств — это константы, которые можно использовать для легкой ссылки на свойство. Теги свойств для свойств, определенных MAPI, включаются в MAPITAGS. Файл заголовка H и в элементе ulPropTag структуры SPropValue . Клиенты и поставщики услуг используют теги свойств для идентификации, извлечения и обновления соответствующих свойств.
Структура SPropTagArray — это подсчитываемый массив тегов свойств. Многие методы в IMAPIProp и других интерфейсах используют структуру SPropTagArray для описания свойств.