WrapCompressedRTFStreamEx
Область применения: Outlook 2013 | Outlook 2016
Распаковывает текст сообщения электронной почты в сжатом формате RTF, указывает формат распаковки потока, при необходимости преобразует распакованный поток в его собственный формат и возвращает распакованный поток или преобразованный собственный поток.
Краткие сведения
| Свойство | Значение |
|---|---|
| Экспортировано: |
msmapi32.dll |
| Вызывающая сторона: |
Клиент |
| Реализовано в: |
Outlook |
HRESULT __stdcall WrapCompressedRTFStreamEx(
LPSTREAM lpCompressedRTFStream,
CONST RTF_WCSINFO *pWCSInfo,
LPSTREAM *lppUncompressedRTFStream,
RTF_WCSRETINFO *pRetInfo);
Параметры
lpCompressedRTFStream
[в] Это указатель на поток, открытый в каноническом свойстве PidTagRtfCompressed сообщения.
pWCSInfo
[в] Это указатель на
RTF_WCSINFO структура, содержащая параметры функции.
lppUncompressedRTFStream
[out] Это указатель на расположение, в котором возвращается поток для распаковки RTF.
pRetInfo
[out] Это указатель на структуру RTF_WCSRETINFO , содержащую сведения о формате возвращаемого распаковки потока.
Возвращаемые значения
S_OK
- Вызов функции выполнен успешно.
MAPI_E_INVALID_PARAMETER
- Возвращается, если флаг MAPI_NATIVE_BODY объединен с флагом MAPI_MODIFY в поле ulFlags структуры RTF_WCSINFO , на которую указывает pWCSInfo.
Замечания
WrapCompressedRTFStreamEx позволяет получить доступ к тексту сообщения электронной почты, инкапсулированного в сжатый RTF, распаковывает поток, возвращает распаковку потока и его формат, а также при необходимости собственный поток текста. Собственный основной поток может быть в формате RTF, обычного текста или HTML.
Объектная модель Microsoft Office Outlook предоставляет свойство Body для объектов MailItem и свойство MailItem.BodyFormat (Outlook), указывающее формат основного текста. По умолчанию решение, которое не является доверенным для Outlook, вызывает диалоговые окна безопасности, созданные Outlook Security Guard. Использование экспортируемой функции MAPI WrapCompressedRTFStreamEx позволяет решению использовать MAPI вместо объектной модели Outlook и избегать этих диалоговых окон безопасности.
Так как флаг MAPI_NATIVE_BODY нельзя объединить с флагом MAPI_MODIFY в поле ulFlags структуры RTF_WCSINFO , на которую указывает pWCSInfo, доступ к собственному потоку текста можно получить только в режиме только для чтения. Чтобы получить доступ к собственному потоку текста в режиме чтения и записи, следует использовать функцию WrapCompressedRTFStream .