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以及以下内容。
返回代码 | 说明 |
---|---|
|
初始化成功。 |
|
应用程序处理程序不处理同步事件。 |
注解
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 |