Programdan Eşitleme Yöneticisi kullanma

Uygulamanızın Eşitleme Yöneticisi ile çalışmasını sağlamak için, SyncMgr'den aldığınız eşitleme bildirimlerini işlemek için bir Bileşen Nesne Modeli (COM) nesnesi uygulamanız gerekir. Uygulamanızın işleyicisi, işlediğiniz öğeler için eşitleme gerçekleştirir. İşleyicinize dahil ISyncMgrSynchronize arabirimini uygulamanız gerekir. Ayrıca, uygulamanızın eşitleyebileceği ayrı öğeler için bir numaralandırıcı nesnesi ve ISyncMgrEnumItems sağlamanız gerekir.

SyncMgr, ISyncMgrSynchronizeCallback ve ISyncMgrSynchronizeInvokeuygular.

SyncMgr, uygulamanızın işlediği öğeler hakkında bilgi almak ve bu öğeleri eşitlemek için sağladığınız işleyici hakkında bilgi almak amacıyla ISyncMgrSynchronize yöntemlerini çağırır.

Çalışma zamanında, eşitleme işlemi şu adımları izler.

1. SyncMgr, ISyncMgrSynchronize::Initialize yönteminizi çağırarak uygulamanızın işlediği öğelerden biri için eşitlemenin zamanının geldiğini bildirir.
2. SyncMgr, uygulamanız tarafından işlenen öğeler için ISyncMgrEnumItems arabirimini almak için ISyncMgrSynchronize::EnumSyncMgrItemsçağırır.
3. SyncMgr, ISyncMgrSynchronizeCallback arabirimi için işleyicinize arabirim işaretçisi sağlamak üzere ISyncMgrSynchronize::SetProgressCallbackçağırır. İşleyiciniz eşitleme sırasında SyncMgr'ye geri çağırmak için bu arabirimi kullanır.
4. SyncMgr daha sonra ISyncMgrSynchronize::P repareForSync yönteminizi çağırarak işleyicinize eşitleme başlamadan önce gerekli olan tüm kullanıcı arabirimi öğelerini görüntüleme şansı verir. Örneğin, bir e-posta uygulaması bir kullanıcı oturum açma iletişim kutusu görüntüleyebilir.
5. İşleyiciniz, tüm kullanıcı arabirimi öğelerini görüntülemeden önce ve görüntüledikten sonra ISyncMgrSynchronizeCallback::EnableModeless çağırır. İşiniz bittiğinde işleyiciniz ISyncMgrSynchronizeCallback::PrepareForSyncCompleted çağırır.
6. SyncMgr, eşitlemeyi başlatmak için ISyncMgrSynchronize::Sync yönteminizi çağırır.

Eşitleme işlemi sırasında SyncMgr, ISyncMgrSynchronize arabiriminizdeki yöntemleri çağırmaya devam eder. İşleyici hatalarınızı, ilerleme durumunuzu ve bildirimlerinizi gönderebilir. Ayrıca, uygulamanızın işlediği öğeleri numaralandırabilir veya uygulamanızın öğeler için özellikleri göstermesine izin verebilir.

İşleyiciniz, bir öğenin atlanması gerekip gerekmediğini belirlemek, hataları günlüğe kaydetmek ve eşitleme işlemi sırasında ilerleme bilgilerini göndermek için ISyncMgrSynchronizeCallbackyöntemlerini çağırır.

Daha fazla bilgi için ilgili arabirimler için ilgili başvuru sayfalarına bakın.

Eşitleme tamamlandığında işleyiciniz ISyncMgrSynchronizeCallback::SynchronizeCompletedçağırır.