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.

Siehe auch