Usando o Gerenciador de Sincronização de um programa

Para permitir que seu aplicativo funcione com o Gerenciador de Sincronização, você deve implementar um objeto COM (Component Object Model) para lidar com notificações de sincronização recebidas do SyncMgr. O manipulador do aplicativo executa a sincronização para os itens que você manipula. Incluído no manipulador, você deve implementar o ISyncMgrSynchronize interface. Além disso, você deve fornecer um objeto enumerador e ISyncMgrEnumItems para quaisquer itens separados que seu aplicativo possa sincronizar.

SyncMgr implementa ISyncMgrSynchronizeCallback e ISyncMgrSynchronizeInvoke.

O SyncMgr chama métodos em seu ISyncMgrSynchronize para obter informações sobre os itens que seu aplicativo manipula e informações sobre o manipulador que você fornece para sincronizar esses itens.

No tempo de execução, o processo de sincronização segue estas etapas.

1. O SyncMgr notifica a sua aplicação de que é tempo de proceder à sincronização para um dos itens que a sua aplicação manipula através do método ISyncMgrSynchronize::Initialize.
2. O SyncMgr chama ISyncMgrSynchronize::EnumSyncMgrItems para obter a interfaceISyncMgrEnumItemspara os itens manipulados pelo seu aplicativo.
3. O SyncMgr chama ISyncMgrSynchronize::SetProgressCallback para fornecer ao manipulador o ponteiro da interface para a interface ISyncMgrSynchronizeCallback. Seu manipulador usa essa interface para chamar de volta para o SyncMgr durante a sincronização.
4. Em seguida, o SyncMgr chama o método ISyncMgrSynchronize::PrepareForSync no seu para dar ao seu manipulador a oportunidade de exibir qualquer elemento da interface do utilizador necessário antes do início da sincronização. Por exemplo, um aplicativo de email pode exibir uma caixa de diálogo de logon do usuário.
5. Seu manipulador chama ISyncMgrSynchronizeCallback::EnableModeless antes e depois de exibir quaisquer elementos da interface do usuário. O seu gerenciador chama ISyncMgrSynchronizeCallback::PrepareForSyncCompleted quando terminar.
6. O SyncMgr chama seu método ISyncMgrSynchronize::Synchronize para iniciar a sincronização.

Durante o processo de sincronização, o SyncMgr continua a chamar métodos em seu interface de ISyncMgrSynchronize. Pode enviar ao seu gestor erros, progresso e notificações. Ele também pode enumerar através dos itens que seu aplicativo manipula ou permitir que seu aplicativo mostre propriedades para os itens.

Seu manipulador chama métodos em ISyncMgrSynchronizeCallback para determinar se um item deve ser ignorado, registrar erros e postar informações de progresso durante o processo de sincronização.

Para obter mais informações, consulte as páginas de referência relacionadas para as interfaces envolvidas.

Quando a sincronização é concluída, o manipulador chama ISyncMgrSynchronizeCallback::SynchronizeCompleted.