RTFSync
Aplica-se a: Outlook 2013 | Outlook 2016
Verifique se o texto da mensagem RTF (Rich Text Format) corresponde à versão de texto simples. É necessário chamar essa função antes de ler a versão RTF e depois de modificar a versão RTF.
| Propriedade | Valor |
|---|---|
| Arquivo de cabeçalho: |
Mapiutil.h |
| Implementado por: |
MAPI |
| Chamado por: |
Aplicativos cliente com reconhecimento RTF e provedores de repositório de mensagens |
HRESULT RTFSync(
LPMESSAGE lpMessage,
ULONG ulFlags,
BOOL FAR * lpfMessageUpdated
);
Parâmetros
Lpmessage
[in] Ponteiro para a mensagem a ser atualizada.
ulFlags
[in] A máscara de bits de sinalizadores usada para indicar a versão de texto simples ou RTF da mensagem foi alterada. Os seguintes sinalizadores podem ser definidos:
RTF_SYNC_BODY_CHANGED: a versão de texto simples da mensagem foi alterada.
RTF_SYNC_RTF_CHANGED: a versão RTF da mensagem foi alterada.
Todos os outros bits no parâmetro ulFlags são reservados para uso futuro.
lpfMessageUpdated
[out] Ponteiro para uma variável que indica se há uma mensagem atualizada. TRUE se houver uma mensagem atualizada, FALSE caso contrário.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
Comentários
Se a propriedade PR_RTF_IN_SYNC (PidTagRtfInSync) estiver ausente ou for FALSE, antes de ler a propriedade PR_RTF_COMPRESSED (PidTagRtfCompressed) a função RTFSync deverá ser chamada com o conjunto de sinalizadores RTF_SYNC_BODY_CHANGED.
Se o sinalizador STORE_RTF_OK não estiver definido na propriedade PR_STORE_SUPPORT_MASK (PidTagStoreSupportMask), essa função deverá ser chamada com o sinalizador RTF_SYNC_RTF_CHANGED definido após modificar PR_RTF_COMPRESSED.
Se PR_BODY (PidTagBody) e PR_RTF_COMPRESSED tiverem sido alterados, a função RTFSync deverá ser chamada com ambos os sinalizadores definidos.
Se o valor do parâmetro lpfMessageUpdated for definido como TRUE, o método IMAPIProp::SaveChanges deverá ser chamado para a mensagem. Se SaveChanges não for chamado, as modificações não serão salvas na mensagem.
Os provedores do repositório de mensagens podem usar o RTFSync para manter as propriedades PR_BODY e PR_RTF_COMPRESSED sincronizadas.
Para obter mais informações, consulte Suporte ao texto RTF para provedores de repositório de mensagens.