Función OleConvertOLESTREAMToIStorageEx (ole2.h)
La función OleConvertOLESTREAMToIStorageEx convierte el objeto especificado del modelo de almacenamiento OLE 1 en un objeto de almacenamiento estructurado OLE 2, incluidos los datos de presentación. Se trata de una de varias funciones de compatibilidad.
Sintaxis
HRESULT OleConvertOLESTREAMToIStorageEx(
[in] LPOLESTREAM polestm,
[out] LPSTORAGE pstg,
[out] CLIPFORMAT *pcfFormat,
[out] LONG *plwWidth,
[out] LONG *plHeight,
[out] DWORD *pdwSize,
[out] LPSTGMEDIUM pmedium
);
Parámetros
[in] polestm
Puntero a la secuencia que contiene la representación persistente del objeto en el formato de almacenamiento OLE 1.
[out] pstg
Puntero al objeto de almacenamiento estructurado OLE 2.
[out] pcfFormat
Puntero a donde se devuelve el formato de los datos de presentación. Puede ser NULL, lo que indica la ausencia de datos de presentación.
[out] plwWidth
Puntero a donde se devuelve el valor de ancho (en HIMETRIC) de los datos de presentación.
[out] plHeight
Puntero a donde se devuelve el valor de alto (en HIMETRIC) de los datos de presentación.
[out] pdwSize
Puntero a donde se devuelve el tamaño en bytes de los datos convertidos.
[out] pmedium
Puntero a donde se devuelve la estructura STGMEDIUM para los datos serializados convertidos.
Valor devuelto
Esta función devuelve HRESULT.
Comentarios
Esta función convierte un objeto OLE 1 en un objeto de almacenamiento estructurado OLE 2. Puede usar esta función para actualizar objetos OLE 1 a objetos OLE 2 cuando una nueva versión de la aplicación de objeto admite OLE 2.
Esta función difiere de la función OleConvertOLESTREAMToIStorage en que los datos de presentación leídos de la estructura OLESTREAM se pasan y el objeto de almacenamiento OLE 2 recién creado no contiene un flujo de presentación.
Puesto que esta función puede especificar qué datos de presentación se van a convertir, las aplicaciones que no usan los recursos de almacenamiento en caché predeterminados de OLE, sino que usan los recursos de conversión.
El miembro tymed de STGMEDIUM solo puede ser TYMED_NULL o TYMED_ISTREAM. Si es TYMED_NULL, los datos se devolverán en un identificador global a través del miembro hGlobal de STGMEDIUM; de lo contrario, los datos se escribirán en el miembro pstm de esta estructura.
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 |