WrapCompressedRTFStreamEx
Aplica-se a: Outlook 2013 | Outlook 2016
Descompacta o corpo de uma mensagem de email que está em RTF (formato de texto rico compactado), indica o formato do fluxo descompactado, converte opcionalmente o fluxo descompactado em seu formato nativo e retorna o fluxo descompactado ou o fluxo nativo convertido.
Informações rápidas
| Propriedade | Valor |
|---|---|
| Exportado por: |
msmapi32.dll |
| Chamado por: |
Cliente |
| Implementado por: |
Outlook |
HRESULT __stdcall WrapCompressedRTFStreamEx(
LPSTREAM lpCompressedRTFStream,
CONST RTF_WCSINFO *pWCSInfo,
LPSTREAM *lppUncompressedRTFStream,
RTF_WCSRETINFO *pRetInfo);
Parâmetros
lpCompressedRTFStream
[in] Este é um ponteiro para um fluxo que é aberto na Propriedade Canônica PidTagRtfCompressed de uma mensagem.
pWCSInfo
[in] Este é um ponteiro para um
RTF_WCSINFO estrutura que contém opções para a função.
lppUncompressedRTFStream
[out] Este é um ponteiro para o local em que um fluxo para o RTF descompactado é retornado.
pRetInfo
[out] Este é um ponteiro para uma estrutura RTF_WCSRETINFO que contém informações sobre o formato do fluxo descompactado retornado.
Valores de retorno
S_OK
- A chamada de função é bem-sucedida.
MAPI_E_INVALID_PARAMETER
- Isso será retornado se o sinalizador MAPI_NATIVE_BODY for combinado com o sinalizador MAPI_MODIFY no campo ulFlags da estrutura RTF_WCSINFO apontada pelo pWCSInfo.
Comentários
WrapCompressedRTFStreamEx permite que você acesse o corpo de uma mensagem de email encapsulada no RTF compactado descompactando o fluxo, retorna o fluxo descompactado e seu formato e, opcionalmente, o fluxo de corpo nativo. O fluxo de corpo nativo pode estar em RTF, texto sem formatação ou HTML.
O modelo de objeto do Microsoft Office Outlook fornece uma propriedade Body para objetos MailItem e uma Propriedade MailItem.BodyFormat (Outlook) que indica o formato do texto do corpo. Por design, uma solução que não é confiável pelo Outlook invoca caixas de diálogo de segurança geradas pelo Outlook Security Guard. Usar a função MAPI exportada WrapCompressedRTFStreamEx permite que uma solução use MAPI em vez do modelo de objeto do Outlook e evite essas caixas de diálogo de segurança.
Como o sinalizador MAPI_NATIVE_BODY não pode ser combinado com o sinalizador MAPI_MODIFY no campo ulFlags da estrutura de RTF_WCSINFO apontada pelo pWCSInfo, você só pode acessar o fluxo de corpo nativo no modo somente leitura. Para acessar o fluxo de corpo nativo no modo de leitura/gravação, use a função WrapCompressedRTFStream .