IStorage::Revert 方法 (objidl.h)

Revert 方法會捨棄自上次認可作業之後對記憶體物件所做的所有變更。

Syntax

HRESULT Revert();

傳回值

這個方法可以傳回下列其中一個值。

傳回碼 描述
S_OK 還原作業成功。
E_PENDING 僅限異步記憶體:目前無法使用部分或所有記憶體的數據。
STG_E_INSUFFICIENTMEMORY 還原作業因記憶體不足而無法完成。
STG_E_TOOMANYOPENFILES 還原作業無法完成,因為有太多開啟的檔案。
STG_E_REVERTED 記憶體物件已因交易樹狀結構中上方的還原作業而失效。

備註

對於以交易模式開啟的儲存物件, IStorage::Revert 方法會捨棄此儲存物件的任何未認可變更,或已從巢狀元素認可至此儲存對象的變更。

這個方法傳回之後,從還原的儲存物件開啟的任何現有專案 (子記憶體或數據流) 無效且無法再使用。 在 IUnknown::Release 以外的任何呼叫中指定這些還原的項目會傳回錯誤STG_E_REVERTED

這個方法不會影響以直接模式開啟的儲存物件。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 objidl.h
程式庫 Uuid.lib
Dll Ole32.dll

另請參閱

IStorage - 複合檔案實作

IStorage::Commit