WrapCompressedRTFStreamEx
适用于:Outlook 2013 | Outlook 2016
解压缩采用 RTF) 压缩格式 (格式的电子邮件正文,指示解压缩流的格式,可以选择将解压缩的流转换为其本机格式,并返回解压缩的流或转换后的本机流。
快速信息
属性 | 值 |
---|---|
导出者: |
msmapi32.dll |
调用者: |
客户端 |
实现者: |
Outlook |
HRESULT __stdcall WrapCompressedRTFStreamEx(
LPSTREAM lpCompressedRTFStream,
CONST RTF_WCSINFO *pWCSInfo,
LPSTREAM *lppUncompressedRTFStream,
RTF_WCSRETINFO *pRetInfo);
参数
lpCompressedRTFStream
[in]这是指向在消息的 PidTagRtfCompressed 规范属性 上打开的流的指针。
pWCSInfo
[in]这是指向 的指针
RTF_WCSINFO 包含函数选项的结构。
lppUncompressedRTFStream
[out]这是指向返回解压缩 RTF 流的位置的指针。
pRetInfo
[out]这是指向 RTF_WCSRETINFO 结构的指针,该结构包含有关返回的解压缩流的格式的信息。
返回值
S_OK
- 函数调用成功。
MAPI_E_INVALID_PARAMETER
- 如果将MAPI_NATIVE_BODY标志与 pWCSInfo 指向的 RTF_WCSINFO 结构的 ulFlags 字段中的 MAPI_MODIFY 标志组合,则会返回此标志。
备注
WrapCompressedRTFStreamEx 允许通过解压缩流、返回解压缩的流及其格式以及本机正文流(可选)来访问封装在压缩 RTF 中的电子邮件正文。 本机正文流可以采用 RTF、纯文本或 HTML 格式。
Microsoft Office Outlook 对象模型为 MailItem 对象提供 Body 属性, (Outlook) 的 MailItem.BodyFormat 属性指示正文文本的格式。 根据设计,不受 Outlook 信任的解决方案会调用 Outlook 安全防护生成的安全对话框。 使用导出的 MAPI 函数 WrapCompressedRTFStreamEx 允许解决方案使用 MAPI 而不是 Outlook 对象模型,并避免这些安全对话框。
由于 MAPI_NATIVE_BODY 标志不能与 pWCSInfo 所指向的 RTF_WCSINFO 结构的 ulFlags 字段中的 MAPI_MODIFY 标志组合使用,因此只能在只读模式下访问本机正文流。 若要在读/写模式下访问本机正文流,应使用 WrapCompressedRTFStream 函数。