Поделиться через

Обработка входящего сообщения

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

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

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

Клиенты регистрируются для получения новых почтовых уведомлений, задав для параметров значение IMsgStore::Advise следующим образом:

  • Задайте для cbEntryID значение 0.

  • Задайте для lpEntryID значение NULL.

  • Задайте для ulEventMask значение fnevNewMail.

Параметр lpNotifications в вызове метода IMAPIAdviseSink::OnNotify указывает на структуру NEWMAIL_NOTIFICATION , которая содержит сведения о входящем сообщении, такие как класс сообщения, идентификатор входа, идентификатор входа родительской папки и содержимое свойства PR_MESSAGE_FLAGS . Дополнительные сведения о регистрации и обработке уведомлений см. в разделах IMAPIAdviseSink::OnNotify, NEWMAIL_NOTIFICATION, PR_MESSAGE_FLAGS (PidTagMessageFlags) и Обработка уведомлений.

Перед отображением входящего сообщения пользователю определите, является ли его класс сообщений классом, поддерживаемым клиентом. Если нет, проигнорируйте сообщение. Если вы поддерживаете класс , вы можете открыть и отобразить сообщение с помощью формы, подходящей для класса сообщения сообщения. Выбор форм основан на классе сообщений. Сообщения, принадлежащие классу IPM, используют форму по умолчанию, реализованную MAPI. Сообщения, принадлежащие пользовательским классам, определенным клиентами, могут использовать либо определяемые клиентом специализированные формы, либо форму MAPI по умолчанию.

Открытие и отображение входящего сообщения

  1. Вызовите IMsgStore::GetReceiveFolder , чтобы получить идентификатор записи папки получения для класса сообщения и передать этот идентификатор записи в IMsgStore::OpenEntry , чтобы открыть папку. Дополнительные сведения см. в разделах IMsgStore::GetReceiveFolder, IMsgStore::OpenEntry и Открытие папки хранилища сообщений.

  2. Вызовите метод IMAPIContainer::GetContentsTable папки получения, чтобы получить ее таблицу содержимого. Дополнительные сведения см. в разделе IMAPIContainer::GetContentsTable. Вызовите метод IMAPITable::QueryRows таблицы, чтобы получить все строки в таблице. Дополнительные сведения см. в разделе IMAPITable::QueryRows и таблицы содержимого. Дополнительные сведения о отображении таблицы содержимого см. в разделе Отображение таблицы содержимого папки.

  3. Если клиент является интерактивным, разрешите пользователю выбрать сообщение из таблицы и определить форму, используемую для отображения этого сообщения. Клиенты могут использовать форму по умолчанию, предоставляемую MAPI, или настраиваемую форму. Дополнительные сведения см. в разделе Обработка форм MAPI.

  4. Вызовите IMsgStore::OpenEntry , чтобы открыть сообщение. Дополнительные сведения см. в разделе Открытие сообщения.

  5. Обработайте текст сообщения. Дополнительные сведения см. в разделе Открытие текста сообщения.

  6. Отрисовка каждого из вложений сообщения. Дополнительные сведения см. в разделах Отрисовка вложения в виде обычного текста или Отрисовка вложения в RTF-тексте.

  7. При необходимости откройте вложение. Дополнительные сведения см. в разделе Открытие вложения.

В этом разделе: