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