Método IOleUndoManager::RedoTo (ocidl.h)
Instrui o gerenciador de desfazer a invocar ações de desfazer novamente por meio da pilha de restauração, até e incluindo a unidade de desfazer especificada.
Sintaxe
HRESULT RedoTo(
[in] IOleUndoUnit *pUU
);
Parâmetros
[in] pUU
Um ponteiro IOleUndoUnit para a unidade de nível superior a ser refazer. Se esse parâmetro for NULL, a unidade de nível superior adicionada mais recentemente será usada.
Retornar valor
Esse método retorna S_OK em caso de êxito. Outros valores retornados possíveis incluem o seguinte.
| Código de retorno | Descrição |
|---|---|
|
A unidade de desfazer especificada não está na pilha de restauração. |
|
Falha na tentativa de desfazer e na tentativa de reversão. O gerenciador de desfazer nunca deve propagar o E_ABORT obtido de uma unidade de desfazer contida. Em vez disso, ele deve mapear quaisquer valores E_ABORT retornados de outras unidades de desfazer para E_FAIL. |
|
O gerenciador de desfazer está desabilitado. |
Comentários
Esse método chama o método IOleUndoUnit::D o em cada unidade de desfazer de nível superior. Em seguida, ele libera essa unidade de desfazer.
Observe que a unidade de desfazer especificada deve ser uma unidade de nível superior, normalmente recuperada por meio de IOleUndoManager::EnumRedoable.
Caso um erro seja retornado da unidade de desfazer, o gerenciador de desfazer precisa tentar reverter o estado do documento para se recuperar do erro executando ações na pilha de desfazer.
Não importa qual seja o êxito da reversão, o gerenciador de desfazer sempre deve limpar ambas as pilhas antes de retornar o erro.
Se o gerenciador de desfazer tiver chamado o método IOleUndoUnit::D o em mais de uma unidade de nível superior, ele só deverá reverter a unidade que retornou o erro. As unidades de nível superior que tiveram êxito não devem ser revertidas.
O gerenciador de desfazer também deve controlar se as unidades foram adicionadas à pilha oposta para que não tente reverter se nada tiver sido adicionado. Consulte a interface IOleUndoManager para obter uma descrição detalhada do tratamento de erros.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | ocidl.h |