Compartilhar via


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
E_INVALIDARG
A unidade de desfazer especificada não está na pilha de restauração.
E_ABORT
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.
E_UNEXPECTED
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

Confira também

IOleUndoManager

IOleUndoManager::EnumRedoable

IOleUndoManager::UndoTo

IOleUndoUnit::D o