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