IOleUndoManager::RedoTo-Methode (ocidl.h)

Weist den Rückgängig-Manager an, Rückgängig-Aktionen zurück über den Wiederholungsstapel aufzurufen, bis und einschließlich der angegebenen Rückgängig-Einheit.

Syntax

HRESULT RedoTo(
  [in] IOleUndoUnit *pUU
);

Parameter

[in] pUU

Ein IOleUndoUnit-Zeiger auf die einheit der obersten Ebene, die wiederholt werden soll. Wenn dieser Parameter NULL ist, wird die zuletzt hinzugefügte Einheit der obersten Ebene verwendet.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode	Beschreibung
E_INVALIDARG	Die angegebene Rückgängig-Einheit befindet sich nicht im Wiederholungsstapel.
E_ABORT	Sowohl der Rückgängig-Versuch als auch der Rollbackversuch sind fehlgeschlagen. Der Rückgängig-Manager sollte niemals die E_ABORT weitergeben, die aus einer enthaltenen Rückgängig-Einheit abgerufen wurden. Stattdessen sollten alle E_ABORT Werte, die von anderen Rückgängig-Einheiten zurückgegeben werden, E_FAIL zugeordnet werden.
E_UNEXPECTED	Der Rückgängig-Manager ist deaktiviert.

Hinweise

Diese Methode ruft die IOleUndoUnit::D o-Methode für jede Rückgängig-Einheit der obersten Ebene auf. Anschließend wird die Rückgängig-Einheit freigegeben.

Beachten Sie, dass die angegebene Rückgängig-Einheit eine Einheit der obersten Ebene sein muss, die in der Regel über IOleUndoManager::EnumRedoable abgerufen wird.

Wenn von der Rückgängig-Einheit ein Fehler zurückgegeben wird, muss der Rückgängig-Manager versuchen, einen Rollback des Zustands des Dokuments auszuführen, um nach dem Fehler wiederherzustellen, indem Er Aktionen für den Rückgängig-Stapel ausführt.

Unabhängig vom Erfolg des Rollbacks sollte der Rückgängig-Manager immer beide Stapel löschen, bevor der Fehler zurückgegeben wird.

Wenn der Rückgängig-Manager die IOleUndoUnit::D o-Methode für mehr als eine Einheit der obersten Ebene aufgerufen hat, sollte er nur die Einheit zurücksetzen, die den Fehler zurückgegeben hat. Für die Einheiten der obersten Ebene, die erfolgreich waren, sollte kein Rollback ausgeführt werden.

Der Rückgängig-Manager muss auch nachverfolgen, ob Einheiten dem entgegengesetzten Stapel hinzugefügt wurden, damit er kein Rollback versucht, wenn nichts hinzugefügt wurde. Eine ausführliche Beschreibung der Fehlerbehandlung finden Sie in der IOleUndoManager-Schnittstelle .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ocidl.h

Weitere Informationen

IOleUndoManager

IOleUndoManager::EnumRedoable

IOleUndoManager::UndoTo

IOleUndoUnit::D o