RTFSync
S’applique à : Outlook 2013 | Outlook 2016
Vérifie que le texte du message RTF (Rich Text Format) correspond à la version en texte brut. Il est nécessaire d’appeler cette fonction avant de lire la version RTF et après avoir modifié la version RTF.
| Propriété | Valeur |
|---|---|
| Fichier d’en-tête : |
Mapiutil.h |
| Implémenté par : |
MAPI |
| Appelé par : |
Applications clientes prenant en charge RTF et fournisseurs de magasins de messages |
HRESULT RTFSync(
LPMESSAGE lpMessage,
ULONG ulFlags,
BOOL FAR * lpfMessageUpdated
);
Paramètres
lpMessage
[in] Pointeur vers le message à mettre à jour.
ulFlags
[in] Masque de bits des indicateurs utilisés pour indiquer que la version RTF ou texte brut du message a changé. Les indicateurs suivants peuvent être définis :
RTF_SYNC_BODY_CHANGED : la version en texte brut du message a changé.
RTF_SYNC_RTF_CHANGED : la version RTF du message a changé.
Tous les autres bits du paramètre ulFlags sont réservés pour une utilisation ultérieure.
lpfMessageUpdated
[out] Pointeur vers une variable indiquant s’il existe un message mis à jour. TRUE s’il existe un message mis à jour ; sinon, FALSE.
Valeur renvoyée
S_OK
L'appel a r�ussi et a renvoy� la valeur attendue ou les valeurs.
Remarques
Si la propriété PR_RTF_IN_SYNC (PidTagRtfInSync) est manquante ou a la valeur FALSE, avant de lire la propriété PR_RTF_COMPRESSED (PidTagRtfCompressed), la fonction RTFSync doit être appelée avec l’indicateur RTF_SYNC_BODY_CHANGED défini.
Si l’indicateur STORE_RTF_OK n’est pas défini dans la propriété PR_STORE_SUPPORT_MASK (PidTagStoreSupportMask), cette fonction doit être appelée avec l’indicateur RTF_SYNC_RTF_CHANGED défini après avoir modifié PR_RTF_COMPRESSED.
Si PR_BODY (PidTagBody) et PR_RTF_COMPRESSED ont été modifiés, la fonction RTFSync doit être appelée avec les deux indicateurs définis.
Si la valeur du paramètre lpfMessageUpdated est définie sur TRUE, la méthode IMAPIProp ::SaveChanges doit être appelée pour le message. Si SaveChanges n’est pas appelé, les modifications ne sont pas enregistrées dans le message.
Les fournisseurs de magasins de messages peuvent utiliser RTFSync pour maintenir la synchronisation des propriétés PR_BODY et PR_RTF_COMPRESSED .
Pour plus d’informations, consultez Prise en charge du texte RTF pour les fournisseurs de magasin de messages.