Använda Synkroniseringshanteraren från ett program

Om du vill att programmet ska fungera med Synkroniseringshanteraren måste du implementera ett COM-objekt (Component Object Model) för att hantera synkroniseringsmeddelanden som du får från SyncMgr. Programmets hanterare utför synkroniseringen för de objekt som du hanterar. Du måste implementera ISyncMgrSynchronize-gränssnittet som ingår i hanteraren. Du måste också ange ett uppräkningsobjekt och ISyncMgrEnumItems för alla separata objekt som programmet kan synkronisera.

SyncMgr implementerar ISyncMgrSynchronizeCallback och ISyncMgrSynchronizeInvoke.

SyncMgr anropar metoder i din ISyncMgrSynchronize för att få information om de objekt som programmet hanterar och information om den hanterare som du anger för synkronisering av dessa objekt.

Vid körningen följer synkroniseringsprocessen dessa steg.

1. SyncMgr meddelar ditt program att det är dags för synkronisering för något av de objekt som programmet hanterar genom att anropa din ISyncMgrSynchronize::Initiera-metoden.
2. SyncMgr anropar ISyncMgrSynchronize::EnumSyncMgrItems för att hämta gränssnittet ISyncMgrEnumItems för de objekt som hanteras av programmet.
3. SyncMgr anropar ISyncMgrSynchronize::SetProgressCallback för att ge hanteraren gränssnittspekaren för ISyncMgrSynchronizeCallback-gränssnittet. Hanteraren använder det här gränssnittet för att anropa SyncMgr under synkroniseringen.
4. SyncMgr anropar sedan din ISyncMgrSynchronize::P repareForSync metod för att ge hanteraren en chans att visa alla användargränssnittselement som krävs innan synkroniseringen börjar. Ett e-postprogram kan till exempel visa en dialogruta för användarinloggning.
5. Hanteraren anropar ISyncMgrSynchronizeCallback::EnableModeless före och efter visning av användargränssnittselement. Hanteraren anropar ISyncMgrSynchronizeCallback::PrepareForSyncCompleted när du är klar.
6. SyncMgr anropar din ISyncMgrSynchronize::Synkronisera-metoden för att starta synkroniseringen.

Under synkroniseringsprocessen fortsätter SyncMgr att anropa metoder i ditt ISyncMgrSynchronize--gränssnitt. Den kan skicka hanterarens fel, framsteg och meddelanden. Den kan också räkna upp genom de objekt som ditt program hanterar eller tillåta att programmet visar egenskaper för objekten.

Hanteraren anropar metoder i ISyncMgrSynchronizeCallback för att avgöra om ett objekt ska hoppas över, logga fel och publicera förloppsinformation under synkroniseringsprocessen.

Mer information finns på de relaterade referenssidorna för de berörda gränssnitten.

När synkroniseringen är klar anropar hanteraren ISyncMgrSynchronizeCallback::SyncCompleted.