ISyncMgrSynchronize：：Synchronize 方法 (mobsync.h)

项目
08/24/2023

在用户选择要同步的已注册应用程序后，由同步管理器为每个所选组调用一次。

语法

HRESULT Synchronize(
  [in] HWND hWndParent
);

parameters

[in] hWndParent

类型：HWND

注册的应用程序应将其用于显示的任何用户界面元素的父 HWND 的句柄。此值可以为 NULL。

返回值

类型： HRESULT

此方法支持标准返回值、E_INVALIDARG、E_UNEXPECTED和E_OUTOFMEMORY，以及以下内容：

返回代码	说明
S_OK	同步成功。
E_FAIL	同步失败。

注解

如果用户未为已注册的应用程序选择任何项选项，则不会调用 ISyncMgrSynchronize：：Synchronize 方法，并且会释放接口。如果调用此方法，应用程序必须同步 ISyncMgrSynchronize：:P repareForSync 方法中指定的项。

已注册应用程序的处理程序应尽快从 ISyncMgrSynchronize：：Synchronize 方法返回，然后调用 SynchronizeCompleted 方法。处理程序可以在从 ISyncMgrSynchronize：：Synchronize 方法返回之前调用 SynchronizeCompleted 调用。

应用程序必须提供进度反馈，并检查是否应使用 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