ISyncMgrHandlerCollection::BindToHandler 方法 (syncmgr.h)
由同步中心调用时实例化指定的同步处理程序。
语法
HRESULT BindToHandler(
[in] LPCWSTR pszHandlerID,
[in] REFIID riid,
[out] void **ppv
);
参数
[in] pszHandlerID
类型: LPCWSTR
同步处理程序的 ID。
[in] riid
类型: REFIID
请求的接口的 IID。 这通常是IID_ISyncMgrHandler。 如果方法在IID_ISyncMgrHandler传递时失败,则会使用 IID_ISyncMgrSynchronize(旧版 ISyncMgrSynchronize 接口的 IID)召回该方法。 当该方法成功返回时,将在 ppv 参数中引用指向所请求接口的指针。
[out] ppv
类型: void**
此方法返回时,包含指向表示同步处理程序的接口的指针的地址。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
同步中心可以在不首先调用 ISyncMgrHandlerCollection::GetHandlerEnumerator 的情况下调用此方法。 这是因为同步中心缓存有关处理程序及其项的信息。 处理程序集合可以返回现有同步处理程序的接口指针,也可以创建新实例。
要求
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | syncmgr.h |