OleConvertOLESTREAMToIStorageEx 函数 (ole2.h)

OleConvertOLESTREAMToIStorageEx 函数将指定的对象从 OLE 1 存储模型转换为包含表示数据的 OLE 2 结构化存储对象。 这是几个兼容性函数之一。

语法

HRESULT OleConvertOLESTREAMToIStorageEx(
  [in]  LPOLESTREAM polestm,
  [out] LPSTORAGE   pstg,
  [out] CLIPFORMAT  *pcfFormat,
  [out] LONG        *plwWidth,
  [out] LONG        *plHeight,
  [out] DWORD       *pdwSize,
  [out] LPSTGMEDIUM pmedium
);

参数

[in] polestm

指向包含对象持久表示形式的 OLE 1 存储格式的流的指针。

[out] pstg

指向 OLE 2 结构化存储对象的指针。

[out] pcfFormat

指向返回演示文稿数据格式的位置的指针。 可能为 NULL,表示缺少演示数据。

[out] plwWidth

指向在 HIMETRIC) 中返回演示文稿数据的宽度值 (的指针。

[out] plHeight

指向返回演示文稿数据的 HIMETRIC) 高度值 (的指针。

[out] pdwSize

指向返回转换数据的大小(以字节为单位)的位置的指针。

[out] pmedium

指向返回转换的序列化数据的 STGMEDIUM 结构的指针。

返回值

此函数返回 HRESULT。

注解

此函数将 OLE 1 对象转换为 OLE 2 结构化存储对象。 当新版本的对象应用程序支持 OLE 2 时,可以使用此函数将 OLE 1 对象更新为 OLE 2 对象。

此函数与 OleConvertOLESTREAMToIStorage 函数的不同之处在于,从 OLESTREAM 结构读取的演示文稿数据会传递出去,并且新创建的 OLE 2 存储对象不包含演示文稿流。

由于此函数可以指定要转换的表示数据,因此,不使用 OLE 的默认缓存资源但使用转换资源的应用程序可以使用它。

STGMEDIUMtymed 成员只能TYMED_NULL或TYMED_ISTREAM。 如果TYMED_NULL,则数据将通过 STGMEDIUMhGlobal 成员在全局句柄中返回,否则数据将写入此结构的 pstm 成员。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 ole2.h
Library Ole32.lib
DLL Ole32.dll

另请参阅

CoIsOle1Class

OleConvertIStorageToOLESTREAM

OleConvertIStorageToOLESTREAMEx

OleConvertOLESTREAMToIStorage

STGMEDIUM

TYMED