IChangeApplicationServices::ReportItemChangeApplied

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

HRESULT ReportItemChangeApplied(
  ISyncChange * pChange);

Parameters

  • pChange
    [in] The item change that was successfully applied to the destination replica.

Return Value

  • S_OK.

  • E_OUTOFMEMORY.

  • E_POINTER.

  • SYNC_E_ACTIVE_CHANGE_APPLICATION_CONTEXT when an IChangeApplicationContext object is already active. The active IChangeApplicationContext object must be processed until its IChangeApplicationContext::GetChangeApplicationAction method returns CAA_FINISHED before another change can be processed.

  • SYNC_E_CHANGE_NEEDS_KNOWLEDGE when pChange does not contain made-with knowledge.

  • SYNC_E_ID_FORMAT_MISMATCH when the format of a specified ID does not match the ID format schema specified when this object was initialized.

  • SYNC_E_INVALID_OPERATION when change application has not been started for a change batch, or when pChange has already been reported as successfully applied or conflicting, or when pChange contains change units that were previously reported as having failed by a call to IChangeApplicationServices::ReportRecoverableErrorOnChangeUnitChange.

  • SYNC_E_FORGOTTEN_KNOWLEDGE_NOT_CONTAINED when the learned knowledge for the change does not contain the learned forgotten knowledge.

Remarks

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

When pChange contains change units that were previously reported as having failed, this method returns an error. To report change units that were successfully applied but were previously reported as failed, call IChangeApplicationServices::ReportChangeUnitChangeApplied for each change unit.

This method fires the ISyncCallback2::OnChangeApplied event.

See Also

Reference

IChangeApplicationServices Interface