ISyncMgrSynchronize::Initialize 方法 (mobsync.h)

由注册的应用程序处理程序中的同步管理器调用,以确定处理程序是否处理同步事件。

语法

HRESULT Initialize(
  [in] DWORD      dwReserved,
  [in] DWORD      dwSyncMgrFlags,
  [in] DWORD      cbCookie,
  [in] const BYTE *lpCookie
);

parameters

[in] dwReserved

类型:DWORD

保留;必须为 0 (零) 。

[in] dwSyncMgrFlags

类型:DWORD

描述如何启动同步事件的 SYNCMGRFLAG 枚举值。

[in] cbCookie

类型:DWORD

lpCookie 数据的大小(以字节为单位)。

[in] lpCookie

类型: BYTE const*

指向标识应用程序的令牌的指针。 当应用程序以编程方式调用同步管理器时,将传递此令牌。

返回值

类型: HRESULT

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

返回代码 说明
S_OK
初始化成功。
S_FALSE
应用程序处理程序不处理同步事件。

注解

SYNCMGRFLAG 枚举值在 ISyncMgrSynchronize 接口的生存期内应用,并由其他 ISyncMgrSynchronize 方法使用。

如果应用程序无法识别 SYNCMGRFLAG 事件,则应用程序应将事件视为手动同步。

注册的应用程序处理程序无法在此调用中显示用户界面,除非这是首次调用初始化方法。 应用程序可以显示设置项和向用户介绍应用程序功能所需的任何一次性初始化。 如果需要在同步过程中出于不同原因显示用户界面,可以使用 ISyncMgrSynchronize::P repareForSync 方法。

lpCookie 参数为 NULL,除非处理应用程序使用 UpdateItems 以编程方式调用同步管理器。 在此方案中,CLSID) (类标识符标识处理应用程序, lpCookie 的值由处理应用程序传入,然后由同步管理器在同步期间传回上下文。 仅当设置了SYNCMGRFLAG_INVOKE时,lpCookie 参数才有意义。

要求

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

另请参阅

ISyncMgrSynchronize

ISyncMgrSynchronize::P repareForSync

SYNCMGRFLAG

UpdateItems