ISyncProviderRegistration::CreateSyncProviderRegistrationInstance method (syncregistration.h)

Article
02/22/2024

Creates an in-memory instance of a synchronization provider.

Syntax

HRESULT CreateSyncProviderRegistrationInstance(
  [in]  const SyncProviderConfiguration *pProviderConfiguration,
  [out] ISyncProviderInfo               **ppProviderInfo
);

Parameters

[in] pProviderConfiguration

A SyncProviderConfiguration structure that contains the synchronization provider registration information.

[out] ppProviderInfo

Returns a pointer to an ISyncProviderInfo interface that is used to obtain information about the synchronization provider and access the configuration property store in order to store the synchronization provider configuration.

Return value

The possible return codes include, but are not limited to, the values shown in the following table.

Return code	Description
S_OK	The method succeeded.
E_POINTER	Invalid pointer.
SYNC_E_REGISTRATION_ALREADYREGISTERED	The same unique instance ID has already been registered for a synchronization provider.

Remarks

The synchronization provider is not registered on the system until the ISyncProviderInfo::Commit method is called. This method is inherited by ISyncProviderInfo from IPropertyStore. For an example of this, see Overview of Registering a Synchronization Provider.

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Target Platform	Windows
Header	syncregistration.h