返回特定唯一实例 ID 的初始化和实例化的 IRegisteredSyncProvider 对象。
语法
HRESULT GetSyncProviderFromInstanceId(
[in] LPCGUID pguidInstanceId,
[in] DWORD dwClsContext,
[out] IRegisteredSyncProvider **ppSyncProvider
);
参数
[in] pguidInstanceId
IRegisteredSyncProvider 对象的唯一实例 ID。
[in] dwClsContext
管理新创建对象的代码将在其中运行上下文。 唯一支持的上下文是 CLSCTX_INPROC_SERVER。
[out] ppSyncProvider
初始化和实例化的同步提供程序对象。
返回值
可能的返回代码包括但不限于下表中显示的值。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
无效指针。 |
|
实例 ID 为GUID_NULL。 |
|
没有足够的内存可用于创建同步提供程序。 |
|
同步提供程序的 CLSID 未注册到请求的上下文中,或者提供程序尚未注册其 DLL。 |
|
未注册具有指定实例 ID 的同步提供程序。 |
注解
注意 此方法的调用方不应对返回的 IRegisteredSyncProvider 对象显式调用 IRegisteredSyncProvider ::Init,因为此方法将代表调用方执行此操作。 调用方应在返回的 IRegisteredSyncProvider 对象上调用 QueryInterface,以获取要传递给同步会话的 ISyncProvider 接口。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | syncregistration.h |