OleSaveToStream 函式 (ole.h)
將物件與 IPersistStream 介面一起儲存至指定的數據流。
語法
OLESTATUS OleSaveToStream(
LPOLEOBJECT unnamedParam1,
LPOLESTREAM unnamedParam2
);
參數
unnamedParam1
要儲存至數據流的物件上 IPersistStream 介面的指標。 pPStm 參數不可為 NULL。
unnamedParam2
要儲存物件之數據流上的 IStream 介面指標。
傳回值
此函式會在成功時傳回S_OK。 其他可能的值包括下列專案。
傳回碼 | Description |
---|---|
|
因為磁碟空間不足,所以無法儲存物件。 |
|
pPStm 參數為 NULL。 |
此函式也可以傳回 WriteClassStm 函式或 IPersistStream::Save 方法傳回的任何錯誤值。
備註
此函式可簡化將 實作 IPersistStream 介面的物件儲存至數據流。 在此數據流中,物件的CLSID在資料之前。 擷取數據流時,CLSID 允許適當的程式代碼與數據相關聯。 OleSaveToStream 函式會執行下列動作:
- 呼叫 IPersist::GetClassID 方法以取得物件的 CLSID。
- 使用 WriteClassStm 函式將 CLSID 寫入數據流。
- 呼叫 IPersistStream::Save 方法, 並將 fClearDirty 設定為 TRUE,以清除 物件中的已變更位。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | ole.h (包含 Ole2.h) |
程式庫 | Ole32.lib |
Dll | Ole32.dll |
API 集合 | ext-ms-win-com-ole32-l1-1-1 (於 Windows 8.1) |