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:
| Codice restituito | Descrizione |
|---|---|
|
L'unità di annullamento specificata non è nello stack di ridistribuzione. |
|
Tentativo di annullamento e tentativo di rollback non riuscito. Il gestore di annullamento non deve mai propagare la E_ABORT ottenuta da un'unità di annullamento contenuta. Deve invece eseguire il mapping di qualsiasi E_ABORT valori restituiti da altre unità di annullamento a E_FAIL. |
|
Il gestore di annullamento è disabilitato. |
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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | ocidl.h |