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)
Syntax
'Declaration
Public Sub ReportItemChangeApplied ( _
itemChange As ItemChange _
)
'Usage
Dim instance As ChangeApplicationServices
Dim itemChange As ItemChange
instance.ReportItemChangeApplied(itemChange)
public void ReportItemChangeApplied(
ItemChange itemChange
)
public:
void ReportItemChangeApplied(
ItemChange^ itemChange
)
member ReportItemChangeApplied :
itemChange:ItemChange -> unit
public function ReportItemChangeApplied(
itemChange : ItemChange
)
Parameters
- itemChange
Type: Microsoft.Synchronization.ItemChange
The item change that was successfully applied to the destination replica.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | A required parameter is a null reference (Nothing in Visual Basic). |
| 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. |
Remarks
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.