OleSaveToStream 函数 (ole.h)

将带有 IPersistStream 接口的对象保存到指定的流中。

语法

OLESTATUS OleSaveToStream(
  LPOLEOBJECT unnamedParam1,
  LPOLESTREAM unnamedParam2
);

参数

unnamedParam1

指向要保存到流的对象上的 IPersistStream 接口的指针。 pPStm 参数不能为 NULL。

unnamedParam2

指向要在其中保存对象的流上的 IStream 接口的指针。

返回值

此函数在成功时返回S_OK。 其他可能的值包括以下内容。

返回代码	说明
STGMEDIUM_E_FULL	由于磁盘空间不足，无法保存对象。
OLE_E_BLANK	pPStm 参数为 NULL。

 

此函数还可以返回 WriteClassStm 函数或 IPersistStream：：Save 方法返回的任何错误值。

注解

此函数简化了将实现 IPersistStream 接口的对象保存到流的过程。 在此流中，对象的 CLSID 位于其数据之前。 检索流时，CLSID 允许将适当的代码与数据相关联。 OleSaveToStream 函数执行以下操作：

• 调用 IPersist：：GetClassID 方法以获取对象的 CLSID。
• 使用 WriteClassStm 函数将 CLSID 写入流。
• 调用 IPersistStream：：Save 方法，并将 fClearDirty 设置为 TRUE，这将清除对象中的脏位。

配套帮助程序 OleLoadFromStream 加载以这种方式保存的对象。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	ole.h (包括 Ole2.h)
Library	Ole32.lib
DLL	Ole32.dll
API 集	在 Windows 8.1) 中引入的 ext-ms-win-com-ole32-l1-1-1 (

另请参阅

IPersistStream

IStream

OleLoadFromStream