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

另请参阅

ISyncMgrHandler

ISyncMgrHandlerCollection