ISyncProviderRegistration::GetSyncProviderFromInstanceId-Methode (syncregistration.h)

Gibt ein initialisiertes und instanziiertes IRegisteredSyncProvider-Objekt für die spezifische eindeutige instance-ID zurück.

Syntax

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

Parameter

[in] pguidInstanceId

Die eindeutige instance ID des IRegisteredSyncProvider-Objekts.

[in] dwClsContext

Der Kontext, in dem der Code ausgeführt wird, der das neu erstellte Objekt verwaltet. Der einzige unterstützte Kontext ist CLSCTX_INPROC_SERVER.

[out] ppSyncProvider

Das initialisierte und instanziierte Synchronisierungsanbieterobjekt.

Rückgabewert

Zu den möglichen Rückgabecodes gehören unter anderem die in der folgenden Tabelle aufgeführten Werte.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	Ungültiger Zeiger.
E_INVALIDARG	Die instance-ID ist GUID_NULL.
E_OUTOFMEMORY	Es war nicht genügend Arbeitsspeicher verfügbar, um den Synchronisierungsanbieter zu erstellen.
REGDB_E_CLASSNOTREG	Die CLSID des Synchronisierungsanbieters ist nicht im angeforderten Kontext registriert, oder die DLL des Anbieters wurde nicht registriert.
SYNC_E_REGISTRATION_NOTREGISTERED	Ein Synchronisierungsanbieter mit der angegebenen instance-ID wurde nicht registriert.

Hinweise

Hinweis Der Aufrufer dieser Methode sollte IRegisteredSyncProvider::Init nicht explizit für das zurückgegebene IRegisteredSyncProvider-Objekt aufrufen, da diese Methode dies im Namen des Aufrufers ausführt. Der Aufrufer sollte QueryInterface für das IRegisteredSyncProvider-Objekt aufrufen, das zurückgegeben wird, um eine ISyncProvider-Schnittstelle abzurufen, die an die Synchronisierungssitzung übergeben werden soll.

 

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	syncregistration.h

Weitere Informationen

IRegisteredSyncProvider-Schnittstelle

ISyncProvider-Schnittstelle

ISyncProviderRegistration-Schnittstelle