Método IOleUndoUnit::OnNextAdd (ocidl.h)
Notifica a la unidad de la última fase de reversión de la colección que se ha agregado una nueva unidad.
Sintaxis
HRESULT OnNextAdd();
Valor devuelto
Las implementaciones de este método siempre devuelven S_OK. El tipo de valor devuelto HRESULT solo se usa para la remotabilidad.
Comentarios
Un objeto puede crear una unidad de deshacer para una acción y agregarla al administrador de deshacer, pero puede continuar insertando datos en él a través de interfaces privadas. Cuando la unidad de deshacer recibe una llamada a este método, se comunica de nuevo con el objeto de creación que el contexto ha cambiado. A continuación, el objeto de creación deja de insertar datos en la unidad de deshacer.
La unidad de deshacer primaria llama a este método en su unidad de deshacer secundaria agregada más recientemente para notificar a la unidad secundaria que el contexto ha cambiado y se ha agregado una nueva unidad de deshacer.
Por ejemplo, este método se usa para admitir acciones aproximadas, como escribir, que no tienen un punto claro de finalización, sino que solo se finalizan cuando sucede algo más.
Es posible que no siempre se llame a este método si el administrador de deshacer o una unidad primaria abierta decide descartar la unidad llamando a IUnknown::Release en su lugar. Cualquier conexión que alimenta los datos a la unidad de deshacer en segundo plano a través de interfaces privadas no debe IUnknown::AddRef la unidad de deshacer.
Notas para los implementadores
Tenga en cuenta que las unidades primarias simplemente delegan este método a su unidad secundaria agregada más recientemente. Una unidad primaria debe finalizar la comunicación a través de las interfaces privadas cuando se cierra. Una unidad primaria sabe que se está cerrando cuando recibe S_FALSE de llamar a IOleParentUndoUnit::Close.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 |