IMAPIFolder::GetMessageStatus
Область применения: Outlook 2013 | Outlook 2016
Получает состояние, связанное с сообщением в определенной папке (например, указывает, помечено ли это сообщение для удаления).
HRESULT GetMessageStatus(
ULONG cbEntryID,
LPENTRYID lpEntryID,
ULONG ulFlags,
ULONG FAR * lpulMessageStatus
);
Параметры
cbEntryID
[в] Число байтов в идентификаторе записи, на который указывает параметр lpEntryID .
lpEntryID
[в] Указатель на идентификатор записи для сообщения, состояние которого получено.
ulFlags
[in] ���������������; ������ ���� ����� ����.
lpulMessageStatus
[out] Указатель на указатель на битовую маску флагов, указывающих состояние сообщения. Биты от 0 до 15 зарезервированы и должны быть равны нулю; биты от 16 до 31 доступны для использования для конкретной реализации. Можно задать следующие флаги:
MSGSTATUS_DELMARKED
Сообщение помечено для удаления.
MSGSTATUS_HIDDEN
Сообщение не должно отображаться.
MSGSTATUS_HIGHLIGHTED
Сообщение должно быть выделено.
MSGSTATUS_REMOTE_DELETE
Сообщение помечено для удаления в удаленном хранилище сообщений без скачивания в локальный клиент.
MSGSTATUS_REMOTE_DOWNLOAD
Сообщение помечено для скачивания из удаленного хранилища сообщений в локальный клиент.
MSGSTATUS_TAGGED
Сообщение было помечено для определенной клиентом цели.
Возвращаемое значение
S_OK
Состояние сообщения было успешно извлечено.
Замечания
Метод IMAPIFolder::GetMessageStatus возвращает состояние сообщения. Состояние сообщения хранится в свойстве PR_MSG_STATUS сообщения (PidTagMessageStatus).
Примечания для исполнителей
Настройка, очистка и использование битов состояния сообщения полностью зависит от реализации, за исключением того, что биты от 0 до 15 зарезервированы и должны быть равны нулю. Если сообщения хранятся в поддереве IPM, MAPI резервирует биты от 16 до 31 для использования клиентами IPM. Если вы храните сообщения в других поддеревах, вы можете использовать биты от 16 до 31 в своих целях.
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer::GetNextMessage |
MFCMAPI использует метод IMAPIFolder::GetMessageStatus для получения состояния следующего отображаемого сообщения. |
| MAPIFormFunctions.cpp |
OpenMessageNonModal и OpenMessageModal |
MFCMAPI использует метод IMAPIFolder::GetMessageStatus для получения состояния сообщения, отображаемого для передачи в средство просмотра формы, то есть CMyMAPIFormViewer или IMAPISession::ShowFormForm. |