Korzystanie z menedżera synchronizacji z programu

Aby umożliwić aplikacji pracę z Menedżerem synchronizacji, należy zaimplementować obiekt Modelu obiektów składników (COM) w celu obsługi powiadomień synchronizacji otrzymywanych z programu SyncMgr. Procedura obsługi w Twojej aplikacji wykonuje synchronizację dla obsługiwanych elementów. W programie obsługi należy zaimplementować interfejs ISyncMgrSynchronize. Ponadto należy podać obiekt modułu wyliczającego i ISyncMgrEnumItems dla oddzielnych elementów, które aplikacja może zsynchronizować.

Program SyncMgr implementuje ISyncMgrSynchronizeCallback i ISyncMgrSynchronizeInvoke.

Program SyncMgr wywołuje metody w ISyncMgrSynchronize, aby uzyskać informacje o elementach obsługiwanych przez aplikację oraz o dostarczonym przez Ciebie module do synchronizacji tych elementów.

W czasie wykonywania proces synchronizacji jest zgodny z tymi krokami.

1. Program SyncMgr powiadamia aplikację o tym, że nadszedł czas, aby synchronizacja była wykonywana dla jednego z elementów obsługiwanych przez aplikację przez wywołanie metody ISyncMgrSynchronize::Initialize.
2. Program SyncMgr wywołuje ISyncMgrSynchronize::EnumSyncMgrItems, aby uzyskać interfejsISyncMgrEnumItems dla elementów obsługiwanych przez aplikację.
3. Program SyncMgr wywołuje ISyncMgrSynchronize::SetProgressCallback w celu przekazania programowi obsługi wskaźnika interfejsu dla interfejsu ISyncMgrSynchronizeCallback. Procedura obsługi używa tego interfejsu do wywołania z powrotem do programu SyncMgr podczas synchronizacji.
4. Następnie program SyncMgr wywołuje metodę ISyncMgrSynchronize::PrepareForSync, aby twój obsługujący miał możliwość wyświetlenia dowolnego elementu interfejsu użytkownika niezbędnego przed rozpoczęciem synchronizacji. Na przykład aplikacja poczty e-mail może wyświetlić okno dialogowe logowania użytkownika.
5. Procedura obsługi wywołuje ISyncMgrSynchronizeCallback::EnableModeless zarówno przed, jak i po wyświetleniu jakichkolwiek elementów interfejsu użytkownika. Procedura obsługi wywołuje ISyncMgrSynchronizeCallback::PrepareForSyncCompleted, gdy zakończysz swoje zadanie.
6. Program SyncMgr wywołuje metodę ISyncMgrSynchronize::Synchronize, aby rozpocząć synchronizację.

Podczas procesu synchronizacji program SyncMgr nadal wywołuje metody w interfejsie ISyncMgrSynchronize. Może wysyłać błędy obsługi, postęp i powiadomienia. Może również wyliczać elementy obsługiwane przez aplikację lub zezwalać aplikacji na wyświetlanie właściwości elementów.

Procedura obsługi wywołuje metody w ISyncMgrSynchronizeCallback w celu określenia, czy element powinien zostać pominięty, aby zarejestrować błędy i opublikować informacje o postępie podczas procesu synchronizacji.

Aby uzyskać więcej informacji, zobacz powiązane strony referencyjne dla zaangażowanych interfejsów.

Po zakończeniu synchronizacji obsługujący wywołuje ISyncMgrSynchronizeCallback::SynchronizeCompleted.