Interface ISyncMgrUIOperation (syncmgr.h)

  • Artigo

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.

 
ISyncMgrUIOperation::Run

Executa a exibição real da interface do usuário para um manipulador ou item de sincronização quando solicitado a fazê-lo pelo Centro de Sincronização.

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.
Ao implementar a interface do usuário como uma interface separada, a exibição da interface do usuário pode ser executada independentemente da sincronização. ISyncMgrUIOperation deve ser implementado em um objeto diferente de ISyncMgrHandler ou ISyncMgrSyncItem.

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

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho syncmgr.h