IOleUndoManager::RedoTo 方法 (ocidl.h)
指示復原管理員透過重做堆棧叫用復原動作,並向下叫用復原動作,並包含指定的復原單位。
語法
HRESULT RedoTo(
[in] IOleUndoUnit *pUU
);
參數
[in] pUU
要取消復原之最上層單位的 IOleUndoUnit 指標。 如果此參數為 NULL,則會使用最近新增的最上層單位。
傳回值
此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。
傳回碼 | Description |
---|---|
|
指定的復原單位不在重做堆疊上。 |
|
復原嘗試和復原嘗試都失敗。 復原管理員絕對不應該傳播從自主復原單位取得的E_ABORT。 相反地,它應該會將從其他復原單位傳回的任何E_ABORT值對應至E_FAIL。 |
|
復原管理員已停用。 |
備註
這個方法會在每個最上層復原單位上呼叫 IOleUndoUnit::D o 方法。 然後,它會釋放該復原單位。
請注意,指定的復原單位必須是最上層單位,通常是透過 IOleUndoManager::EnumRedoable 擷取。
如果從復原單位傳回錯誤,復原管理員必須嘗試復原檔的狀態,以在復原堆疊上執行動作,以從錯誤中復原。
不論復原成功為何,復原管理員都應該一律清除這兩個堆棧,再傳回錯誤。
如果復原管理員已在多個最上層單位上呼叫 IOleUndoUnit::D o 方法,則應該只復原傳回錯誤的單位。 不應該復原成功的最上層單位。
復原管理員也必須追蹤是否將單位新增至相反的堆疊,如此就不會在未新增任何項目時嘗試復原。 如需錯誤處理的詳細描述,請參閱 IOleUndoManager 介面。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | ocidl.h |