Método IOleUndoManager::RedoTo (ocidl.h)
Indica al administrador de deshacer que invoque las acciones de deshacer a través de la pila de puesta al día, hasta e incluya la unidad de deshacer especificada.
Sintaxis
HRESULT RedoTo(
[in] IOleUndoUnit *pUU
);
Parámetros
[in] pUU
Puntero IOleUndoUnit a la unidad de nivel superior para rehacer. Si este parámetro es NULL, se usa la unidad de nivel superior agregada más recientemente.
Valor devuelto
Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.
| Código devuelto | Descripción |
|---|---|
|
La unidad de deshacer especificada no está en la pila de rehacer. |
|
Error tanto en el intento de deshacer como en el intento de reversión. El administrador de deshacer nunca debe propagar el E_ABORT obtenido de una unidad de deshacer independiente. En su lugar, debe asignar los valores de E_ABORT devueltos de otras unidades de deshacer a E_FAIL. |
|
El administrador de deshacer está deshabilitado. |
Comentarios
Este método llama al método IOleUndoUnit::D o en cada unidad de deshacer de nivel superior. A continuación, libera esa unidad de deshacer.
Tenga en cuenta que la unidad de deshacer especificada debe ser una unidad de nivel superior, normalmente recuperada a través de IOleUndoManager::EnumRedoable.
En caso de que se devuelva un error desde la unidad de deshacer, el administrador de deshacer debe intentar revertir el estado del documento para recuperarse del error mediante la realización de acciones en la pila de deshacer.
Independientemente del éxito de la reversión, el administrador de deshacer siempre debe borrar ambas pilas antes de devolver el error.
Si el administrador de deshacer ha llamado al método IOleUndoUnit::D o en más de una unidad de nivel superior, solo debe revertir la unidad que devolvió el error. Las unidades de nivel superior que se realizaron correctamente no deben revertirse.
El administrador de deshacer también debe realizar un seguimiento de si las unidades se agregaron a la pila opuesta para que no intente revertir si no se agregó nada. Consulte la interfaz IOleUndoManager para obtener una descripción detallada del control de errores.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | ocidl.h |