ISyncMgrSynchronize：:P repareForSync 方法 (mobsync.h)

项目
08/24/2023

允许已注册的应用程序显示任何用户界面，并在调用 ISyncMgrSynchronize：：Synchronize 方法之前执行任何必要的初始化。例如，Microsoft Outlook 电子邮件客户端等应用程序可能需要显示密码对话框，使用户能够登录到邮件服务器。

语法

HRESULT PrepareForSync(
  [in] ULONG cbNumItems,
  [in] GUID  *pItemIDs,
  [in] HWND  hWndParent,
  [in] DWORD dwReserved
);

parameters

[in] cbNumItems

类型： ULONG

pItemIDs 指向的数组中的项数。

[in] pItemIDs

类型： GUID*

用户选择同步的项 ID 数组。

[in] hWndParent

类型：HWND

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

[in] dwReserved

类型：DWORD

保留。已注册的应用程序应忽略此值。

返回值

类型： HRESULT

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

返回代码	说明
S_OK	准备成功。

注解

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

仅当在 ISyncMgrSynchronize：：Initialize 方法的 dwSyncFlags 参数中设置了SYNCMGRFLAG_MAYBOTHERUSER标志时，已注册的应用程序才应显示用户界面。如果未设置 SYNCMGRFLAG_MAYBOTHERUSER 标志，已注册的应用程序无法在未显示用户界面的情况下准备同步，则应从此方法返回S_FALSE。

传递到此方法的项 ID 数组也与 ISyncMgrSynchronize：：Synchronize 方法相关。

可以在已注册的应用程序中的任何线程上调用 ISyncMgrSynchronizeCallback 方法。

要求


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	mobsync.h
DLL	Mobsync.dll