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 文字。