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


RTFSync

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

Убедитесь, что текст сообщения в формате RTF соответствует версии обычного текста. Эту функцию необходимо вызвать перед чтением версии RTF и после изменения версии RTF.

Свойство Значение
Файл заголовка:
Mapiutil.h
Реализовано в:
MAPI
Вызывающая сторона:
Клиентские приложения и поставщики хранилища сообщений с поддержкой RTF
HRESULT RTFSync(
  LPMESSAGE lpMessage,
  ULONG ulFlags,
  BOOL FAR * lpfMessageUpdated
);

Параметры

lpMessage

[в] Указатель на сообщение, которое требуется обновить.

ulFlags

[в] Битовая маска флагов, используемых для указания того, что версия rtf или обычного текста сообщения изменилась. Можно задать следующие флаги:

  • RTF_SYNC_BODY_CHANGED: изменена версия сообщения в виде обычного текста.

  • RTF_SYNC_RTF_CHANGED: версия сообщения в RTF изменена.

Все остальные биты в параметре ulFlags зарезервированы для использования в будущем.

lpfMessageUpdated

[out] Указатель на переменную, указывающую, есть ли обновленное сообщение. Значение TRUE, если сообщение обновлено, в противном случае — FALSE.

Возвращаемое значение

S_OK

����� ������� � ������ ��������� ��������� ��� ��������.

Замечания

Если свойство PR_RTF_IN_SYNC (PidTagRtfInSync) отсутствует или имеет значение FALSE, перед чтением свойства PR_RTF_COMPRESSED (PidTagRtfCompressed) следует вызвать функцию RTFSync с установленным флагом RTF_SYNC_BODY_CHANGED.

Если флаг STORE_RTF_OK не задан в свойстве PR_STORE_SUPPORT_MASK (PidTagStoreSupportMask), эту функцию следует вызывать с флагом RTF_SYNC_RTF_CHANGED, заданным после изменения PR_RTF_COMPRESSED.

Если оба PR_BODY (PidTagBody) и PR_RTF_COMPRESSED были изменены, следует вызвать функцию RTFSync с установленными флагами.

Если для параметра lpfMessageUpdated задано значение TRUE, для сообщения следует вызвать метод IMAPIProp::SaveChanges . Если метод SaveChanges не вызывается, изменения не будут сохранены в сообщении.

Поставщики хранилища сообщений могут использовать RTFSync для синхронизации свойств PR_BODY и PR_RTF_COMPRESSED .

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

См. также