WrapCompressedRTFStream
Hace referencia a: Outlook 2013 | Outlook 2016
Crea una secuencia de texto en formato de texto enriquecido (RTF) sin comprimir a partir del formato comprimido usado en la propiedad PR_RTF_COMPRESSED (PidTagRtfCompressed).
| Propiedad | Valor |
|---|---|
| Archivo de encabezado: |
Mapidefs.h |
| Implementado por: |
MAPI |
| Llamado por: |
Aplicaciones cliente |
HRESULT WrapCompressedRTFStream(
LPSTREAM lpCompressedRTFStream,
ULONG ulflags,
LPSTREAM FAR * lpUncompressedRTFStream
);
Parameters
lpCompressedRTFStream
[in] Puntero a una secuencia abierta en la propiedad PR_RTF_COMPRESSED de un mensaje.
ulFlags
[in] Máscara de bits de marcas de opción para la función. Se pueden establecer las siguientes marcas:
MAPI_MODIFY
Si el cliente tiene intención de leer o escribir la interfaz de flujo encapsulada que se devuelve.
STORE_UNCOMPRESSED_RTF
RTF sin comprimir debe escribirse en la secuencia a la que apunta lpCompressedRTFStream
lpUncompressedRTFStream
[out] Puntero a la ubicación donde WrapCompressedRTFStream devuelve una secuencia para rtf sin comprimir.
Valor devuelto
S_OK
La llamada se ha realizado correctamente y devuelva el valor esperado o los valores.
Comentarios
Si se pasa la marca de MAPI_MODIFY en el parámetro ulFlags , el parámetro lpCompressedRTFStream ya debe estar abierto para leer y escribir. El texto RTF nuevo y sin comprimir debe escribirse en la interfaz de flujo devuelta en lpUncompressedRTFStream. Dado que no es posible anexar la secuencia existente, se debe escribir todo el texto del mensaje.
Si se pasa cero en el parámetro ulFlags , lpCompressedRTFStream se puede abrir de solo lectura. Solo se puede leer todo el texto del mensaje fuera de la interfaz de flujo devuelta en lpUncompressedRTFStream. No es posible buscar a partir del medio de la secuencia.
WrapCompressedRTFStream supone que el puntero del flujo comprimido está establecido al principio de la secuencia. Algunos métodos OLE IStream no son compatibles con el flujo sin comprimir devuelto. Estos incluyen IStream::Clone, IStream::LockRegion, IStream::Revert, IStream::Seek, IStream::SetSize, IStream::Stat e IStream::UnlockRegion. Para copiar en toda la secuencia, se necesita un bucle de lectura y escritura.
Dado que el cliente escribe un nuevo RTF en formato sin comprimir, debe usar WrapCompressedRTFStream, en lugar de escribir directamente en la secuencia. Los clientes compatibles con RTF deben buscar la marca de STORE_UNCOMPRESSED_RTF en la propiedad PR_STORE_SUPPORT_MASK (PidTagStoreSupportMask) y pasarla a WrapCompressed RTFStream si está establecida.