Función OleConvertOLESTREAMToIStorageEx (ole2.h)

Artículo
03/15/2023

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