OleConvertOLESTREAMToIStorageEx 函数 (ole2.h)

项目
03/13/2024

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 的默认缓存资源但使用转换资源的应用程序可以使用它。

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

要求

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