ISyncProviderRegistration::GetSyncProviderFromInstanceId 方法 (syncregistration.h)

返回特定唯一实例 ID 的初始化和实例化的 IRegisteredSyncProvider 对象。

语法

HRESULT GetSyncProviderFromInstanceId(
  [in]  LPCGUID                 pguidInstanceId,
  [in]  DWORD                   dwClsContext,
  [out] IRegisteredSyncProvider **ppSyncProvider
);

参数

[in] pguidInstanceId

IRegisteredSyncProvider 对象的唯一实例 ID。

[in] dwClsContext

管理新创建对象的代码将在其中运行上下文。 唯一支持的上下文是 CLSCTX_INPROC_SERVER

[out] ppSyncProvider

初始化和实例化的同步提供程序对象。

返回值

可能的返回代码包括但不限于下表中显示的值。

返回代码 说明
S_OK
方法成功。
E_POINTER
无效指针。
E_INVALIDARG
实例 ID 为GUID_NULL
E_OUTOFMEMORY
没有足够的内存可用于创建同步提供程序。
REGDB_E_CLASSNOTREG
同步提供程序的 CLSID 未注册到请求的上下文中,或者提供程序尚未注册其 DLL。
SYNC_E_REGISTRATION_NOTREGISTERED
未注册具有指定实例 ID 的同步提供程序。

注解

注意 此方法的调用方不应对返回的 IRegisteredSyncProvider 对象显式调用 IRegisteredSyncProvider ::Init,因为此方法将代表调用方执行此操作。 调用方应在返回的 IRegisteredSyncProvider 对象上调用 QueryInterface,以获取要传递给同步会话的 ISyncProvider 接口。
 

要求

要求
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 syncregistration.h

另请参阅

IRegisteredSyncProvider 接口

ISyncProvider 接口

ISyncProviderRegistration 接口