IKnowledgeSyncProvider::ProcessChangeBatch method (winsync.h)

Processes a set of changes by detecting conflicts and applying changes to the item store.

Syntax

HRESULT ProcessChangeBatch(
  [in]      CONFLICT_RESOLUTION_POLICY resolutionPolicy,
  [in]      ISyncChangeBatch           *pSourceChangeBatch,
  [in]      IUnknown                   *pUnkDataRetriever,
  [in]      ISyncCallback              *pCallback,
  [in, out] SYNC_SESSION_STATISTICS    *pSyncSessionStatistics
);

Parameters

[in] resolutionPolicy

The conflict resolution policy to use when this method applies changes.

[in] pSourceChangeBatch

A batch of changes from the source provider to be applied locally.

[in] pUnkDataRetriever

An object that can be used to retrieve change data. It can be an ISynchronousDataRetriever object or a provider-specific object.

[in] pCallback

An object that receives event notifications during change application.

[in, out] pSyncSessionStatistics

Tracks change statistics. For a provider that uses custom change application, this object must be updated with the results of the change application.

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.
Provider-determined error codes

Remarks

When a source change contains change unit changes, the destination provider must determine which, if any, change unit versions to include in the batch of destination versions that is sent to the change applier. This decision depends on the kind of change from the source provider and whether the item is marked as deleted on the destination replica.

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 winsync.h

See also

CONFLICT RESOLUTION POLICY Enumeration

IKnowledgeSyncProvider Interface