Metodo IOleUndoManager::RedoTo (ocidl.h)

Indica al gestore di annullamento di richiamare le azioni di annullamento tramite lo stack di ripristino, fino a e includere l'unità di annullamento specificata.

Sintassi

HRESULT RedoTo(
  [in] IOleUndoUnit *pUU
);

Parametri

[in] pUU

Puntatore IOleUndoUnit all'unità di primo livello da ripetere. Se questo parametro è NULL, viene usata l'unità di primo livello aggiunta più di recente.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:

Commenti

Questo metodo chiama il metodo IOleUndoUnit::D o in ogni unità di annullamento di primo livello. Quindi, rilascia l'unità di annullamento.

Si noti che l'unità di annullamento specificata deve essere un'unità di primo livello, in genere recuperata tramite IOleUndoManager::EnumRedoable.

Nel caso in cui venga restituito un errore dall'unità di annullamento, la gestione annulla deve tentare di eseguire il rollback dello stato del documento per il ripristino dall'errore eseguendo azioni nello stack di annullamento.

Indipendentemente dal successo del rollback, il gestore di annullamento deve sempre cancellare entrambi gli stack prima di restituire l'errore.

Se il gestore annulla ha chiamato il metodo IOleUndoUnit::D o in più unità di primo livello, dovrebbe eseguire il rollback dell'unità che ha restituito l'errore. Le unità di primo livello che hanno esito positivo non devono essere rollback.

Il gestore di annullamento deve tenere traccia anche del fatto che le unità siano state aggiunte allo stack opposto in modo che non tenti il rollback se non è stato aggiunto nulla. Per una descrizione dettagliata della gestione degli errori, vedere l'interfaccia IOleUndoManager .

Requisiti

Vedi anche

IOleUndoManager

IOleUndoManager::EnumRedoable

IOleUndoManager::UndoTo

IOleUndoUnit::D o