Метод ISyncProviderRegistration::GetSyncProviderFromInstanceId (syncregistration.h)

  • Статья

Возвращает инициализированный и созданный экземпляр объекта IRegisteredSyncProvider для конкретного уникального идентификатора экземпляра.

Синтаксис

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

Параметры

[in] pguidInstanceId

Уникальный идентификатор экземпляра объекта IRegisteredSyncProvider .

[in] dwClsContext

Контекст, в котором будет выполняться код, который управляет вновь созданным объектом. Единственный поддерживаемый контекст — CLSCTX_INPROC_SERVER.

[out] ppSyncProvider

Инициализированный и созданный экземпляр объекта поставщика синхронизации.

Возвращаемое значение

Возможные коды возврата включают, но не ограничиваются ими, значения, показанные в следующей таблице.

Код возврата Описание
S_OK
 Метод выполнен успешно.
E_POINTER
 Недопустимый указатель.
E_INVALIDARG
 Идентификатор экземпляра GUID_NULL.
E_OUTOFMEMORY
 Недостаточно памяти для создания поставщика синхронизации.
REGDB_E_CLASSNOTREG
 CLSID поставщика синхронизации не зарегистрирован в запрошенном контексте или у поставщика не зарегистрирована библиотека DLL.
SYNC_E_REGISTRATION_NOTREGISTERED
Поставщик синхронизации с указанным идентификатором экземпляра не зарегистрирован.

Комментарии

Примечание Вызывающий объект этого метода не должен явно вызывать IRegisteredSyncProvider::Init для возвращаемого объекта IRegisteredSyncProvider , так как этот метод будет выполнять это от имени вызывающего объекта. Вызывающий объект должен вызвать QueryInterface для объекта IRegisteredSyncProvider , который возвращается для получения интерфейса ISyncProvider для передачи в сеанс синхронизации.
 

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header syncregistration.h

См. также раздел

Интерфейс IRegisteredSyncProvider

Интерфейс ISyncProvider

Интерфейс ISyncProviderRegistration