Общие сведения о свойствах сообщения
Область применения: Outlook 2013 | Outlook 2016
MAPI делит свойства сообщений на три типа:
Свойства содержимого сообщения.
Свойства передачи сообщений или конверта.
Свойства получателя сообщения.
Свойства содержимого сообщения описывают текст сообщения. Каждый класс сообщений имеет собственный набор свойств содержимого. MAPI определяет свойства содержимого для заметок и сообщений отчетов; клиенты и поставщики хранилища сообщений, обрабатывающие эти классы сообщений, должны задать свойства соответствующим образом для своих реализаций. PR_BODY (PidTagBody) и PR_RTF_COMPRESSED (PidTagRtfCompressed) — это примеры свойств содержимого для сообщений с заметками. PR_BODY содержит неформатированное содержимое заметки, а PR_RTF_COMPRESSED — сжатую версию отформатированного содержимого заметки. Дополнительные сведения о диапазонах идентификаторов свойств см. в разделе Диапазоны идентификаторов свойств.
Для новых классов сообщений клиенты могут определять свойства содержимого одним из двух способов:
С помощью идентификаторов свойств в диапазоне свойств содержимого пользовательского класса сообщений: 0x6800 через 0x7BFF.
С помощью именованных свойств с идентификаторами, которые попадают в 0x8000 через 0xFFFE диапазон.
Диапазон идентификаторов свойств содержимого пользовательского класса сообщений доступен любому клиенту, который создает пользовательский класс сообщений. Таким образом, один идентификатор свойства в этом диапазоне можно использовать для нескольких классов сообщений. Пользователи свойств в этом диапазоне не могут делать предположения о поведении свойств.
Для именованных свойств клиенты создают имя, указывающее набор свойств и строку символов или числовое значение для каждого нового свойства. Затем клиенты связывают свойство с идентификатором в диапазоне именованных свойств. Пользователи именованных свойств получают доступ к ним по имени или идентификатору с помощью методов IMAPIProp::GetIDsFromNames и IMAPIProp::GetNamesFromIDs .
Свойства конверта предоставляют сведения, используемые для передачи сообщения от одного получателя к другому. Как и в случае со свойствами содержимого сообщения, клиенты или поставщики услуг могут определить собственные свойства конверта, чтобы дополнить свойства, определяемые MAPI. Клиенты и поставщики транспорта задают свойства конверта, определяемые MAPI, на основе определения, которое предоставляет MAPI. Поставщики транспорта, реализующие специальные функции, могут определять собственные свойства конверта, чтобы предоставить эти функции клиентам. MAPI выделяет диапазон идентификаторов свойств, которые можно использовать для этих специальных свойств, определенных поставщиком. Поставщики транспорта обычно реализуют специальную страницу свойств, чтобы отобразить эти свойства и разрешить клиентам изменять их. примерами свойств конверта являются PR_SUBJECT (PidTagSubject) и PR_MESSAGE_CLASS (PidTagMessageClass). Дополнительные сведения см. в разделе Диапазоны идентификаторов свойств.
Свойства получателя описывают назначение отправленного сообщения. Получатель может быть пользователем сообщений, списком рассылки или компьютером. Свойства получателя определяются MAPI и задаются поставщиками услуг. Некоторые свойства получателей поддерживаются поставщиками адресных книг для объектов пользователей и списков рассылки для обмена сообщениями. другие свойства получателя поддерживаются клиентами, поставщиками хранилища сообщений или поставщиками транспорта. Например, всем получателям требуется адрес и тип адреса; это свойства, поддерживаемые поставщиком адресной книги, когда получатель хранится в одном из своих контейнеров. Получатели также имеют тип , PR_RECIPIENT_TYPE (PidTagRecipientType), который определяет получателя как основного, углеродного или слепого получателя углеродной копии.
Многие свойства сообщения являются необязательными, что означает, что клиенты не могут ожидать, что они будут доступны или имеют допустимые значения. Некоторые свойства сообщения являются обязательными, но доступны только в том случае, если сообщение находится в определенном состоянии. Например, только что созданному сообщению не требуется идентификатор записи до тех пор, пока сообщение не будет сохранено, и не требуется иметь класс сообщения, пока сообщение не будет готово к отправке. Клиенты всегда должны проверка результаты вызовов IMAPIProps::GetProps и IMAPIProp::OpenProperty и иметь значения по умолчанию, готовые в качестве резервной копии, если запрошенное свойство недоступно.
Большинство свойств сообщений, заданных поставщиками услуг, доступны только для чтения для клиентов.