OleSave 函式 (ole2.h)

將以交易模式開啟的物件儲存至指定的儲存物件。

語法

HRESULT OleSave(
  [in] LPPERSISTSTORAGE pPS,
  [in] LPSTORAGE        pStg,
  [in] BOOL             fSameAsLoad
);

參數

[in] pPS

要儲存之物件上的 IPersistStorage 介面指標。

[in] pStg

目的地儲存物件上 IStorage 介面的指標，要儲存 pPS 中所指出的物件。

[in] fSameAsLoad

TRUE 表示 pStg 與載入或建立物件的儲存物件相同; FALSE 表示已從不同的儲存物件載入或建立 pStg 。

傳回值

此函式會在成功時傳回S_OK。 其他可能的值包括下列專案。

傳回碼	Description
STGMEDIUM_E_FULL	因為磁碟空間不足，所以無法儲存物件。 此函式也可以傳回 IPersistStorage：：Save 方法傳回的任何錯誤值。

備註

OleSave 協助程式函式會處理在交易模式中開啟物件的常見情況，然後儲存到使用 OLE 提供的複合檔案實作的指定儲存物件中。 交易模式表示對象的變更會經過緩衝處理，直到呼叫 IStorage：：Commit 或 IStorage：：Revert 為止。 呼叫端可以直接呼叫 IPersistStorage 和 IStorage 介面來處理其他情況。

OleSave 會執行下列動作：

• 呼叫 IPersist：：GetClassID 方法以取得物件的 CLSID。
• 使用 WriteClassStg 函式將 CLSID 寫入記憶體物件。
• 呼叫 IPersistStorage：：Save 方法來儲存物件。
• 如果儲存時沒有任何錯誤;會呼叫 IStorage：：Commit 方法來認可變更。

注意 靜態物件會儲存到名為 CONTENTS 的數據流中。 靜態元檔物件會以「可置放元檔格式」儲存，而靜態 DIB 數據會以「DIB 檔格式」儲存。 這些格式會定義為元檔和 DIB 的 OLE 標準。 使用 IStream 介面或透過 IDataObject：：GetDataHere () 傳輸的所有資料都必須採用下列格式。 此外，預設檔案格式為元檔或 DIB 的所有物件都必須使用這些標準格式將數據寫入 CONTENTS 數據流。

 

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	ole2.h
程式庫	Ole32.lib
Dll	Ole32.dll
API 集合	ext-ms-win-com-ole32-l1-1-3 (Windows 10 10.0.10240 版)

另請參閱

IPersistStorage

IStorage