OleSaveToStream 函数 (ole.h)
将带有 IPersistStream 接口的对象保存到指定的流中。
语法
OLESTATUS OleSaveToStream(
LPOLEOBJECT unnamedParam1,
LPOLESTREAM unnamedParam2
);
参数
unnamedParam1
指向要保存到流的对象上的 IPersistStream 接口的指针。 pPStm 参数不能为 NULL。
unnamedParam2
指向要在其中保存对象的流上的 IStream 接口的指针。
返回值
此函数在成功时返回S_OK。 其他可能的值包括以下内容。
返回代码 | 说明 |
---|---|
|
由于磁盘空间不足,无法保存对象。 |
|
pPStm 参数为 NULL。 |
此函数还可以返回 WriteClassStm 函数或 IPersistStream::Save 方法返回的任何错误值。
注解
此函数简化了将实现 IPersistStream 接口的对象保存到流的过程。 在此流中,对象的 CLSID 位于其数据之前。 检索流时,CLSID 允许将适当的代码与数据相关联。 OleSaveToStream 函数执行以下操作:
- 调用 IPersist::GetClassID 方法以获取对象的 CLSID。
- 使用 WriteClassStm 函数将 CLSID 写入流。
- 调用 IPersistStream::Save 方法,并将 fClearDirty 设置为 TRUE,这将清除对象中的脏位。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 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 ( |