Synchronisatiebeheer gebruiken vanuit een programma

Als u wilt dat uw toepassing kan werken met Synchronization Manager, moet u een COM-object (Component Object Model) implementeren om synchronisatiemeldingen te verwerken die u van SyncMgr ontvangt. De handler van uw toepassing voert de synchronisatie uit voor de items die u verwerkt. U moet de ISyncMgrSynchronize interface implementeren in uw handler. U moet ook een enumerator-object en ISyncMgrEnumItems opgeven voor afzonderlijke items die door uw toepassing kunnen worden gesynchroniseerd.

SyncMgr implementeert ISyncMgrSynchronizeCallback- en ISyncMgrSynchronizeInvoke-.

De SyncMgr roept methoden aan in uw ISyncMgrSynchronize om informatie te krijgen over de items die uw toepassing verwerkt en informatie over de handler die u opgeeft voor het synchroniseren van deze items.

Tijdens runtime volgt het synchronisatieproces deze stappen.

1. SyncMgr meldt uw toepassing dat het tijd is voor synchronisatie voor een van de items die door uw toepassing worden verwerkt door uw ISyncMgrSynchronize aan te roepen::Initialiseer methode.
2. SyncMgr roept ISyncMgrSynchronize::EnumSyncMgrItems aan om de ISyncMgrEnumItems interface te verkrijgen voor de items die door uw toepassing worden verwerkt.
3. SyncMgr roept ISyncMgrSynchronize::SetProgressCallback- aan om uw handler te voorzien van de interfaceaanwijzer voor de ISyncMgrSynchronizeCallback interface. Uw handler gebruikt deze interface om tijdens de synchronisatie terug te bellen naar de SyncMgr.
4. SyncMgr roept vervolgens uw ISyncMgrSynchronize::P repareForSync methode aan om uw handler een kans te geven om elk element van de gebruikersinterface weer te geven dat nodig is voordat de synchronisatie begint. In een e-mailtoepassing kan bijvoorbeeld een dialoogvenster voor gebruikersaanmelding worden weergegeven.
5. Uw handler roept ISyncMgrSynchronizeCallback::EnableModeless voor en na het weergeven van elementen van de gebruikersinterface. De handler roept ISyncMgrSynchronizeCallback::PrepareForSyncCompleted aan wanneer u klaar bent.
6. SyncMgr roept uw ISyncMgrSynchronize::Sync methode aan om de synchronisatie te starten.

Tijdens het synchronisatieproces blijft SyncMgr methoden aanroepen in uw ISyncMgrSynchronize interface. Het kan uw handlerfouten, voortgang en meldingen verzenden. Het kan ook de items opsommen die door uw toepassing worden verwerkt of toestaan dat uw toepassing eigenschappen voor de items weergeeft.

Uw handler roept methoden aan in ISyncMgrSynchronizeCallback- om te bepalen of een item moet worden overgeslagen, fouten te registreren en voortgangsinformatie te posten tijdens het synchronisatieproces.

Zie de gerelateerde referentiepagina's voor de betrokken interfaces voor meer informatie.

Wanneer de synchronisatie is voltooid, roept uw handler ISyncMgrSynchronizeCallback::SyncCompletedaan.