ISyncMgrSynchronize：：Synchronize 方法 (mobsync.h)

發行項
08/24/2023

在使用者選擇要同步處理已註冊的應用程式之後，由同步處理管理員針對每個選取的群組呼叫一次。

語法

HRESULT Synchronize(
  [in] HWND hWndParent
);

參數

[in] hWndParent

類型： HWND

已註冊應用程式的父 HWND 控制碼應該用於它所顯示的任何使用者介面元素。此值可以是 Null。

傳回值

類型： HRESULT

這個方法支援標準傳回值、E_INVALIDARG、E_UNEXPECTED和E_OUTOFMEMORY，以及下列專案：

傳回碼	描述
S_OK	同步處理成功。
E_FAIL	同步處理失敗。

備註

如果使用者未為已註冊的應用程式選取任何專案選項，則不會呼叫 ISyncMgrSynchronize：：Synchronize 方法，並釋放介面。如果呼叫這個方法，應用程式必須同步處理 ISyncMgrSynchronize：:P repareForSync 方法中指定的專案。

已註冊的應用程式處理常式應該儘快從 ISyncMgrSynchronize：：Synchronize 方法傳回，然後呼叫 SynchronizeCompleted 方法。處理常式可以接受先呼叫 SynchronizeCompleted 呼叫，再從 ISyncMgrSynchronize：：Synchronize 方法傳回。

應用程式必須提供進度意見反應，並使用ISyncMgrSynchronize：：SetProgressCallback方法中設定的pSyncCallBack介面指標來檢查是否應該取消同步處理。

即使ISyncMgrSynchronize：：Initialize中未指定SYNCMGRFLAG_MAYBOTHERUSER旗標，應用程式也必須提供進度資訊。

應用程式應該嘗試不要在 ISyncMgrSynchronize：：Synchronize 方法中顯示使用者介面元素。任何使用者介面元素都應該顯示在 ISyncMgrSynchronize：:P repareForSync 和 ISyncMgrSynchronize：：ShowError 方法中，讓終端使用者體驗一致的使用者介面，其僅限於登入及指定要同步處理的共用。接著，不需要任何使用者介入即可執行同步處理。同步處理完成之後，即可顯示衝突或其他錯誤訊息。

您可以在應用程式中的任何執行緒上呼叫 ISyncMgrSynchronizeCallback 方法。

需求


最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	mobsync.h
Dll	Mobsync.dll