Interfaz ISyncMgrUIOperation (syncmgr.h)

  • Artículo

Expone un método a través del cual un controlador de sincronización o un elemento de sincronización pueden mostrar un objeto de interfaz de usuario cuando lo solicite el Centro de sincronización.

Herencia

La interfaz ISyncMgrUIOperation hereda de la interfaz IUnknown . ISyncMgrUIOperation también tiene estos tipos de miembros:

Métodos

La interfaz ISyncMgrUIOperation tiene estos métodos.

 
ISyncMgrUIOperation::Run

Realiza la visualización real de la interfaz de usuario para un controlador o elemento de sincronización cuando se solicita hacerlo mediante el Centro de sincronización.

Comentarios

Los controladores implementan ISyncMgrUIOperation para proporcionar la interfaz de usuario para una acción determinada. Cada acción independiente (examinar, programar, habilitar/deshabilitar, activar/desactivar y eliminar) requiere una implementación independiente.

Un controlador solo debe implementar esta interfaz para las operaciones para las que desea presentar la interfaz de usuario.

A continuación se resumen los pasos que se llevan a cabo en el Centro de sincronización para crear instancias y usar esta interfaz.

  1. El Centro de sincronización crea un subproceso independiente para la operación de interfaz de usuario.
  2. El Centro de sincronización crea una nueva instancia del controlador.
  3. Si la operación solo implica un controlador, el Centro de sincronización llama a ISyncMgrHandler::GetObject con el identificador de objeto de SYNCMGR_OBJECTID adecuado para obtener un puntero a ISyncMgrUIOperation que implementa ese objeto de interfaz de usuario. Por ejemplo, el Centro de sincronización llama a ISyncMgrHandler::GetObject con SYNCMGR_OBJECTID_QueryBeforeDelete para obtener un objeto al que se llama para mostrar la interfaz de usuario cuando el usuario decide eliminar el controlador, solicitando una confirmación de que realmente desea eliminarlo.
  4. Si la operación implica un elemento de sincronización, el Centro de sincronización realiza una serie de llamadas, incluidas las siguientes:
    1. Se llama a QueryInterface en la interfaz ISyncMgrHandler para recuperar una instancia de ISyncMgrSyncItemContainer.
    2. Se llama a ISyncMgrSyncItemContainer::GetSyncItem para obtener un puntero a la instancia de ISyncMgrSyncItem que representa el elemento.
    3. Se llama a ISyncMgrSyncItem::GetObject con el identificador de objeto de SYNCMGR_OBJECTID adecuado para obtener un puntero a ISyncMgrUIOperation que implementa el objeto de interfaz de usuario.
  5. El Centro de sincronización llama al método Run del objeto de interfaz de usuario para mostrar la interfaz de usuario.
Al implementar la interfaz de usuario como una interfaz independiente, la visualización de la interfaz de usuario se puede realizar independientemente de la sincronización. ISyncMgrUIOperation debe implementarse en un objeto diferente que ISyncMgrHandler o ISyncMgrSyncItem.

Si el usuario solicita una acción, vuelve a solicitar esa misma acción antes de que se haya completado la primera, la interfaz de usuario de la acción inicial se activa y se lleva al primer plano.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado syncmgr.h