ChangeApplicationServices::ReportItemChangeApplied Method

Notifies the change application service that an item change has been successfully applied to the destination replica.

Namespace:  Microsoft.Synchronization
Assembly:  Microsoft.Synchronization (in Microsoft.Synchronization.dll)

public:
void ReportItemChangeApplied(
	ItemChange^ itemChange
)

Parameters

itemChange
Type: Microsoft.Synchronization::ItemChange
The item change that was successfully applied to the destination replica.

ExceptionCondition
ArgumentNullException

A required parameter is a nullptr.

ActiveChangeApplicationContextException

A ChangeApplicationContext object is already active. The active ChangeApplicationContext object must be processed until its ChangeApplicationAction property is set to Finished before another change can be processed.

ChangeNeedsKnowledgeException

itemChange does not contain made-with knowledge.

SyncIdFormatMismatchException

The ID format schema of the knowledge object contained in itemChange does not match the ID format schema specified when this object was initialized.

SyncInvalidOperationException

Change application was not started or itemChange has already been reported as successfully applied or conflicting.

ForgottenKnowledgeNotContainedException

The learned knowledge for the change does not contain the learned forgotten knowledge.

When itemChange contains change units, all change units are reported as successfully applied, except change units that are in conflict.

When itemChange contains change units that were previously reported as having failed, this method throws an exception. To report change units that were successfully applied but were previously reported as failed, call ReportChangeUnitChangeApplied for each change unit.

Show: