OleSaveToStream 函数 (ole2.h)

  • 项目

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

语法

HRESULT OleSaveToStream(
  [in] LPPERSISTSTREAM pPStm,
  [in] LPSTREAM        pStm
);

参数

[in] pPStm

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

[in] pStm

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

返回值

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

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

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

注解

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

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

要求

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

另请参阅

IPersistStream

IStream

OleLoadFromStream