Interface ISyncMgrUIOperation (syncmgr.h)

Expõe um método por meio do qual um manipulador de sincronização ou item de sincronização pode exibir um objeto de interface do usuário quando solicitado a fazê-lo pelo Sync Center.

Herança

A interface ISyncMgrUIOperation herda da interface IUnknown . ISyncMgrUIOperation também tem estes tipos de membros:

Métodos

A interface ISyncMgrUIOperation tem esses métodos.

Comentários

Os manipuladores implementam ISyncMgrUIOperation para fornecer a interface do usuário para uma ação específica. Cada ação separada (procurar, agendar, habilitar/desabilitar, ativar/desativar e excluir) requer uma implementação separada.

Um manipulador só deve implementar essa interface para operações para as quais deseja apresentar a interface do usuário.

O exemplo a seguir resume as etapas que o Centro de Sincronização executa para instanciar e usar essa interface.

1. O Centro de Sincronização cria um thread separado para a operação da interface do usuário.
2. O Centro de Sincronização cria uma nova instância do manipulador.
3. Se a operação envolver apenas um manipulador, o Sync Center chamará ISyncMgrHandler::GetObject com a ID de objeto SYNCMGR_OBJECTID apropriada para obter um ponteiro para o ISyncMgrUIOperation que implementa esse objeto de interface do usuário. Por exemplo, o Sync Center chama ISyncMgrHandler::GetObject com SYNCMGR_OBJECTID_QueryBeforeDelete para obter um objeto que é chamado para exibir a interface do usuário quando o usuário opta por excluir o manipulador, solicitando uma confirmação de que realmente deseja excluí-lo.
4. Se a operação envolver um item de sincronização, o Sync Center fará uma série de chamadas, incluindo as seguintes:
   1. QueryInterface é chamado na interface ISyncMgrHandler para recuperar uma instância de ISyncMgrSyncItemContainer.
   2. ISyncMgrSyncItemContainer::GetSyncItem é chamado para obter um ponteiro para a instância ISyncMgrSyncItem que representa o item.
   3. ISyncMgrSyncItem::GetObject é chamado com a ID de objeto de SYNCMGR_OBJECTID apropriada para obter um ponteiro para o ISyncMgrUIOperation que implementa o objeto de interface do usuário.
5. O Sync Center chama o método Run do objeto de interface do usuário para exibir a interface do usuário.

Se o usuário solicitar uma ação, solicitará essa mesma ação novamente antes que a primeira seja concluída, a interface do usuário da ação inicial será ativada e levada para o primeiro plano.

Requisitos