RTFSync
Gilt für: Outlook 2013 | Outlook 2016
Stellt sicher, dass der RtF-Nachrichtentext (Rich Text Format) mit der Nur-Text-Version übereinstimmt. Es ist erforderlich, diese Funktion vor dem Lesen der RTF-Version und nach dem Ändern der RTF-Version aufzurufen.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Mapiutil.h |
| Implementiert von: |
MAPI |
| Aufgerufen von: |
RTF-fähige Clientanwendungen und Nachrichtenspeicheranbieter |
HRESULT RTFSync(
LPMESSAGE lpMessage,
ULONG ulFlags,
BOOL FAR * lpfMessageUpdated
);
Parameter
lpMessage
[in] Zeiger auf die nachricht, die aktualisiert werden soll.
ulFlags
[in] Bitmaske von Flags, die verwendet werden, um anzugeben, dass sich die RTF- oder Nur-Text-Version der Nachricht geändert hat. Die folgenden Flags können festgelegt werden:
RTF_SYNC_BODY_CHANGED: Die Nur-Text-Version der Nachricht wurde geändert.
RTF_SYNC_RTF_CHANGED: Die RTF-Version der Nachricht wurde geändert.
Alle anderen Bits im ulFlags-Parameter sind für die zukünftige Verwendung reserviert.
lpfMessageUpdated
[out] Zeiger auf eine Variable, die angibt, ob eine aktualisierte Nachricht vorhanden ist. TRUE, wenn eine aktualisierte Meldung vorhanden ist, andernfalls FALSE.
Rückgabewert
S_OK
Der Aufruf erfolgreich ausgef�hrt und der erwartete Wert oder Werte zur�ckgegeben hat.
Hinweise
Wenn die eigenschaft PR_RTF_IN_SYNC (PidTagRtfInSync) fehlt oder FALSE ist, sollte vor dem Lesen der eigenschaft PR_RTF_COMPRESSED (PidTagRtfCompressed) die RTFSync-Funktion mit festgelegtem RTF_SYNC_BODY_CHANGED-Flag aufgerufen werden.
Wenn das STORE_RTF_OK-Flag in der eigenschaft PR_STORE_SUPPORT_MASK (PidTagStoreSupportMask) nicht festgelegt ist, sollte diese Funktion mit dem RTF_SYNC_RTF_CHANGED-Flag aufgerufen werden, nachdem PR_RTF_COMPRESSED geändert wurde.
Wenn sowohl PR_BODY (PidTagBody) als auch PR_RTF_COMPRESSED geändert wurden, sollte die RTFSync-Funktion aufgerufen werden, wobei beide Flags festgelegt sind.
Wenn der Wert des Parameters lpfMessageUpdated auf TRUE festgelegt ist, sollte die IMAPIProp::SaveChanges-Methode für die Nachricht aufgerufen werden. Wenn SaveChanges nicht aufgerufen wird, werden die Änderungen nicht in der Nachricht gespeichert.
Nachrichtenspeicheranbieter können RTFSync verwenden, um die eigenschaften PR_BODY und PR_RTF_COMPRESSED synchronisiert zu halten.
Weitere Informationen finden Sie unter Unterstützung von RTF-Text für Nachrichtenspeicheranbieter.