IOleUndoManager::RedoTo メソッド (ocidl.h)

元に戻す操作を元に戻すマネージャーに指示し、指定した元に戻す単位までやり直しスタックから元に戻す操作を呼び出します。

構文

HRESULT RedoTo(
  [in] IOleUndoUnit *pUU
);

[in] pUU

再実行する最上位レベルの単位への IOleUndoUnit ポインター。このパラメーターが NULL の場合は、最後に追加された最上位レベルの単位が使用されます。

このメソッドは、成功したS_OKを返します。その他の可能な戻り値は次のとおりです。

リターンコード	説明
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