Каноническое свойство PidTagMessageRecipients

Статья
04/04/2023

Область применения: Outlook 2013 | Outlook 2016

Содержит таблицу ограничений, которые можно применить к таблице содержимого, чтобы найти все сообщения, содержащие подобъекты получателей, соответствующие ограничениям.

Свойство	Значение
Связанные свойства:	PR_MESSAGE_RECIPIENTS
Идентификатор:	0x0E12
Тип данных:	PT_OBJECT
Область:	Общие сообщения

Замечания

Это свойство можно исключить в операциях IMAPIProp::CopyTo или включить в операции IMAPIProp::CopyProps . Как свойство типа PT_OBJECT, оно не может быть успешно извлечено методом IMAPIProp::GetProps . Доступ к содержимому должен осуществляться методом IMAPIProp::OpenProperty , запрашивая идентификатор интерфейса IID_IMAPITable . Поставщики услуг должны сообщить об этом методу IMAPIProp::GetPropList , если он задан, но при необходимости могут сообщить об этом или нет, если он не задан.

Чтобы получить содержимое таблицы, клиентское приложение должно вызвать метод IMessage::GetRecipientTable .

Это свойство можно использовать для ограничения подобъектов, указав его в структуре SSubRestriction . Это позволяет клиенту ограничить представление контейнера сообщениями с получателями, соответствующими заданным критериям. Сообщение подходит для просмотра, если хотя бы одна строка в таблице получателей, то есть один получатель удовлетворяет ограничению подобъекта.

Примечание Использование результатов ограничения подобъекта эквивалентно вызову IMAPISession::OpenEntry для каждого сообщения в таблице. В зависимости от клиентского приложения и количества сообщений для поиска это может повлиять на производительность.

Свойство PR_MESSAGE_ATTACHMENTS (PidTagMessageAttachments) и это свойство похожи по использованию. Несколько свойств MAPI предоставляют доступ к таблицам:

Свойство	Table
PR_CONTAINER_CONTENTS (PidTagContainerContents)	Таблица содержимого
PR_CONTAINER_HIERARCHY (PidTagContainerHierarchy)	Таблица иерархии
PR_FOLDER_ASSOCIATED_CONTENTS (PidTagFolderAssociatedContents)	Связанная таблица содержимого
PR_MESSAGE_ATTACHMENTS (PidTagMessageAttachments)	Таблица вложений
PR_MESSAGE_RECIPIENTS	Таблица получателей