OleConvertIStorageToOLESTREAMEx 函数 (ole2.h)

项目
02/29/2024

OleConvertIStorageToOLESTREAMEx 函数将指定的存储对象从 OLE 2 结构化存储转换为 OLE 1 存储对象模型，包括表示数据。这是结构化存储中包含的几个函数之一，可确保 OLE1 和 OLE2 之间的兼容性。

语法

HRESULT OleConvertIStorageToOLESTREAMEx(
  [in]  LPSTORAGE   pstg,
  [in]  CLIPFORMAT  cfFormat,
  [in]  LONG        lWidth,
  [in]  LONG        lHeight,
  [in]  DWORD       dwSize,
  [in]  LPSTGMEDIUM pmedium,
  [out] LPOLESTREAM polestm
);

参数

[in] pstg

指向要转换为 OLE 1 存储的存储对象上的 IStorage 接口的指针。

[in] cfFormat

演示文稿数据的格式。可以为 NULL，在这种情况下， 将忽略 lWidth、 lHeight、 dwSize 和 pmedium 参数。

[in] lWidth

对象表示数据的宽度（以 HIMETRIC 为单位）。

[in] lHeight

对象表示数据的高度（以 HIMETRIC 单位为单位）。

[in] dwSize

要转换的数据的大小（以字节为单位）。

[in] pmedium

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

[out] polestm

指向使用 OLE 1 存储模型保存对象的持久表示形式的流的指针。

返回值

此函数支持标准返回值E_INVALIDARG，此外还支持以下值：

注解

OleConvertIStorageToOLESTREAMEx 函数将 OLE 2 存储对象转换为 OLE 1 格式。它与 OleConvertIStorageToOLESTREAM 函数的不同之处在于 ，OleConvertIStorageToOLESTREAMEx 函数也将表示数据传递给 OLE 1 存储对象，而 OleConvertIStorageToOLESTREAM 函数则不传递。

由于 OleConvertIStorageToOLESTREAMEx 可以指定要转换的演示文稿数据，因此不使用 OLE 默认缓存资源但使用 OLE 转换资源的应用程序可以使用它。

STGMEDIUM 的 tymed 成员的值必须是TYMED_HGLOBAL或TYMED_ISTREAM;有关详细信息，请参阅 TYMED 枚举。介质不由 OleConvertIStorageToOLESTREAMEx 函数释放。

要求

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