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

Статья
04/04/2023

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

Содержит 32-разрядную битовую маску флагов, которая определяет состояние сообщения в таблице содержимого.

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

Замечания

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

Клиентское приложение может задать один или несколько из следующих флагов в этом свойстве:

MSGSTATUS_ANSWERED

Сообщение было отправлено.

MSGSTATUS_DELMARKED

Сообщение помечено для последующего удаления.

MSGSTATUS_DRAFT

Сообщение находится в состоянии черновика редакции.

MSGSTATUS_HIDDEN

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

MSGSTATUS_HIGHLIGHTED

Сообщение должно быть выделено на дисплеях в папке получателей.

MSGSTATUS_REMOTE_DELETE

Сообщение помечено для удаления в удаленном хранилище сообщений без скачивания в локальный клиент.

MSGSTATUS_REMOTE_DOWNLOAD

Сообщение помечено для скачивания из удаленного хранилища сообщений в локальный клиент.

MSGSTATUS_TAGGED

Сообщение было помечено для определенной клиентом цели.

Флаги MSGSTATUS_DELMARKED, MSGSTATUS_HIDDEN, MSGSTATUS_HIGHLIGHTED и MSGSTATUS_TAGGED определяются клиентом. Поставщики транспорта и хранилища передают эти биты без каких-либо действий.

Клиенты могут интерпретировать эти значения любым способом, подходящим для их приложений. Одним из способов использования этого свойства многими клиентами является отображение сообщений, помеченных для удаления репрезентативным значком.

Клиент удаленного просмотра может задать MSGSTATUS_REMOTE_DELETE или MSGSTATUS_REMOTE_DOWNLOAD для сообщений в папке заголовка, представленной ему удаленным поставщиком транспорта. Клиентское приложение может проверить каждый заголовок сообщения в этой папке, чтобы определить, следует ли скачать или удалить сообщение в удаленном хранилище сообщений. Затем он использует метод IMAPIFolder::SetMessageStatus , чтобы задать соответствующий флаг. SetMessageStatus — это единственный способ задать любой из флагов в этом свойстве; Невозможно использовать метод IMAPIProp::SetProps . Чтобы получить это свойство, клиенты вызывают IMAPIFolder::GetMessageStatus , а не IMAPIProp::GetProps.

Биты от 16 до 31 (0x10000 по 0x80000000) этого свойства доступны для использования клиентским приложением межличностных сообщений (IPM). Все остальные биты зарезервированы для использования MAPI; значения, не определенные в предыдущей таблице, должны быть изначально равны нулю и не изменены впоследствии.