Таблицы получателей
Область применения: Outlook 2013 | Outlook 2016
Таблица получателей содержит сведения обо всех получателях сообщения. Поставщики хранилища сообщений реализуют таблицы получателей, а клиентские приложения используют их. Клиенты получают доступ к таблице получателей путем вызова метода IMessage::GetRecipientTable или, если поставщик хранилища сообщений поддерживает его, к методу IMAPIProp::OpenProperty . Клиенты получают доступ к таблицам получателей с помощью OpenProperty , указывая PR_MESSAGE_RECIPIENTS (PidTagMessageRecipients) для тега свойства и IID_IMAPITable для идентификатора интерфейса. Изменения в таблице получателей можно внести, вызвав метод IMessage::ModifyRecipients .
Таблицы получателей имеют другой набор столбцов в зависимости от того, было ли отправлено сообщение. Следующие свойства составляют обязательный набор столбцов в таблицах получателей:
PR_DISPLAY_NAME (PidTagDisplayName)
PR_RECIPIENT_TYPE (PidTagRecipientType)
PR_ROWID (PidTagRowid)
Необязательные свойства:
PR_DISPLAY_TYPE (PidTagDisplayType)
PR_ENTRYID (PidTagEntryId)
PR_SPOOLER_STATUS (PidTagSpoolerStatus)
PR_OBJECT_TYPE (PidTagObjectType)
Отправленные сообщения должны включать следующие дополнительные свойства в обязательный набор столбцов:
PR_ADDRTYPE (PidTagAddressType)
PR_RESPONSIBILITY (PidTagResponsibility)
В зависимости от реализации поставщика в таблице могут находиться дополнительные столбцы, такие как PR_SENDER_NAME (PidTagSenderName) и ENTRYID.
Любой поставщик хранилища сообщений, поддерживающий передачу сообщений, как указано в STORE_SUBMIT_OK бите, заданном в свойстве PR_STORE_SUPPORT_MASK поставщика (PidTagStoreSupportMask), должен предоставлять поддержку определенного набора ограничений в реализации таблицы получателей. Ограничения свойств AND, OR существуют и относятся к типам ограничений, которые должны быть доступны пользователям таблицы получателей. Для ограничения свойства должны поддерживаться только операторы равных и не равных. Эти ограничения должны работать со следующими свойствами:
PR_ADDRTYPE
PR_EMAIL_ADDRESS (PidTagEmailAddress)
PR_RECIPIENT_TYPE
PR_RESPONSIBILITY
PR_SPOOLER_STATUS