Función OleConvertIStorageToOLESTREAMEx (ole2.h)
La función OleConvertIStorageToOLESTREAMEx convierte el objeto de almacenamiento especificado del almacenamiento estructurado OLE 2 en el modelo de objetos de almacenamiento OLE 1, incluidos los datos de presentación. Esta es una de las distintas funciones incluidas en Structured Storage para garantizar la compatibilidad entre OLE1 y OLE2.
Sintaxis
HRESULT OleConvertIStorageToOLESTREAMEx(
[in] LPSTORAGE pstg,
[in] CLIPFORMAT cfFormat,
[in] LONG lWidth,
[in] LONG lHeight,
[in] DWORD dwSize,
[in] LPSTGMEDIUM pmedium,
[out] LPOLESTREAM polestm
);
Parámetros
[in] pstg
Puntero a la interfaz IStorage del objeto de almacenamiento que se va a convertir en un almacenamiento OLE 1.
[in] cfFormat
Formato de los datos de presentación. Puede ser NULL, en cuyo caso se omiten los parámetros lWidth, lHeight, dwSize y pmedium .
[in] lWidth
Ancho de los datos de presentación del objeto en unidades HIMETRIC.
[in] lHeight
Alto de los datos de presentación de objetos en unidades HIMETRIC.
[in] dwSize
Tamaño de los datos, en bytes, que se van a convertir.
[in] pmedium
Puntero a la estructura STGMEDIUM de los datos serializados que se van a convertir.
[out] polestm
Puntero a una secuencia en la que la representación persistente del objeto se guarda mediante el modelo de almacenamiento OLE 1.
Valor devuelto
Esta función admite el valor devuelto estándar E_INVALIDARG, además de lo siguiente:
Comentarios
La función OleConvertIStorageToOLESTREAMEx convierte un objeto de almacenamiento OLE 2 en formato OLE 1. Difiere de la función OleConvertIStorageToOLESTREAM en que la función OleConvertIStorageToOLESTREAMEx también pasa los datos de presentación al objeto de almacenamiento OLE 1, mientras que la función OleConvertIStorageToOLESTREAM no.
Dado que OleConvertIStorageToOLESTREAMEx puede especificar qué datos de presentación se van a convertir, las aplicaciones que no usan recursos de almacenamiento en caché predeterminados OLE, sino que usan los recursos de conversión ole.
El valor del miembro tymed de STGMEDIUM debe ser TYMED_HGLOBAL o TYMED_ISTREAM; consulte la enumeración TYMED para obtener más información. La función OleConvertIStorageToOLESTREAMEx no libera el medio.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | ole2.h |
| Library | Ole32.lib |
| Archivo DLL | Ole32.dll |