ISyncProviderRegistration::CreateSyncProviderRegistrationInstance method (syncregistration.h)

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

See also

ISyncProviderRegistration Interface

SyncProviderConfiguration Structure