OleConvertIStorageToOLESTREAMEx 函数 (ole2.h)

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,在这种情况下, 将忽略 lWidthlHeightdwSizepmedium 参数。

[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 转换资源的应用程序可以使用它。

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

要求

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

另请参阅

CoIsOle1Class

OleConvertIStorageToOLESTREAM

OleConvertOLESTREAMToIStorage

OleConvertOLESTREAMToIStorageEx

STGMEDIUM

TYMED