共用方式為


IOleUndoManager::RedoTo 方法 (ocidl.h)

指示復原管理員透過重做堆棧叫用復原動作,並向下叫用復原動作,並包含指定的復原單位。

語法

HRESULT RedoTo(
  [in] IOleUndoUnit *pUU
);

參數

[in] pUU

要取消復原之最上層單位的 IOleUndoUnit 指標。 如果此參數為 NULL,則會使用最近新增的最上層單位。

傳回值

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

傳回碼 Description
E_INVALIDARG
指定的復原單位不在重做堆疊上。
E_ABORT
復原嘗試和復原嘗試都失敗。 復原管理員絕對不應該傳播從自主復原單位取得的E_ABORT。 相反地,它應該會將從其他復原單位傳回的任何E_ABORT值對應至E_FAIL。
E_UNEXPECTED
復原管理員已停用。

備註

這個方法會在每個最上層復原單位上呼叫 IOleUndoUnit::D o 方法。 然後,它會釋放該復原單位。

請注意,指定的復原單位必須是最上層單位,通常是透過 IOleUndoManager::EnumRedoable 擷取。

如果從復原單位傳回錯誤,復原管理員必須嘗試復原檔的狀態,以在復原堆疊上執行動作,以從錯誤中復原。

不論復原成功為何,復原管理員都應該一律清除這兩個堆棧,再傳回錯誤。

如果復原管理員已在多個最上層單位上呼叫 IOleUndoUnit::D o 方法,則應該只復原傳回錯誤的單位。 不應該復原成功的最上層單位。

復原管理員也必須追蹤是否將單位新增至相反的堆疊,如此就不會在未新增任何項目時嘗試復原。 如需錯誤處理的詳細描述,請參閱 IOleUndoManager 介面。

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 ocidl.h

另請參閱

IOleUndoManager

IOleUndoManager::EnumRedoable

IOleUndoManager::UndoTo

IOleUndoUnit::D o