RTFSync
适用于：Outlook 2013 | Outlook 2016
确保 RTF 格式 (RTF) 消息文本与纯文本版本匹配。 在读取 RTF 版本之前和修改 RTF 版本之后，必须调用此函数。
| 属性 | 值 |
|---|---|
| 标头文件： |
Mapiutil.h |
| 实现者： |
MAPI |
| 调用者： |
RTF 感知客户端应用程序和消息存储提供程序 |
HRESULT RTFSync(
LPMESSAGE lpMessage,
ULONG ulFlags,
BOOL FAR * lpfMessageUpdated
);
参数
lpMessage
[in]指向要更新的消息的指针。
ulFlags
[in]用于指示消息 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) 属性之前，应使用设置RTF_SYNC_BODY_CHANGED标志调用 RTFSync 函数。
如果在 PR_STORE_SUPPORT_MASK (PidTagStoreSupportMask) 属性中未设置STORE_RTF_OK标志，则应使用修改PR_RTF_COMPRESSED后设置 RTF_SYNC_RTF_CHANGED标志来调用此函数。
如果 PR_BODY (PidTagBody) 和 PR_RTF_COMPRESSED 都已更改，则应在同时设置这两个标志的情况下调用 RTFSync 函数。
如果 lpfMessageUpdated 参数的值设置为 TRUE，则应为消息调用 IMAPIProp：：SaveChanges 方法。 如果未调用 SaveChanges ，则不会在消息中保存修改。
消息存储提供程序可以使用 RTFSync 使 PR_BODY 和 PR_RTF_COMPRESSED 属性保持同步。
有关详细信息，请参阅 支持消息存储提供程序的 RTF 文本。