IChangeApplicationServices::EndChangeApplication
Ends processing of a set of changes.
Syntax
HRESULT EndChangeApplication(
ISyncKnowledge * pBatchLearnedKnowledge,
ISyncKnowledge ** ppUpdatedDestinationKnowledge);
Parameters
pBatchLearnedKnowledge
[in] The learned knowledge of the change batch.ppUpdatedDestinationKnowledge
[out] Returns the updated destination knowledge, based on the changes that were applied or skipped.
Return Value
S_OK.
E_OUTOFMEMORY.
E_POINTER.
SYNC_E_ID_FORMAT_MISMATCH when the ID format schema of pBatchLearnedKnowledge does not match the ID format schema specified when this object was initialized.
SYNC_E_INVALID_OPERATION when this object has not been initialized, or when change application was not started.
Remarks
The learned knowledge of the change batch, specified by pBatchLearnedKnowledge, is modified by this method to exclude any changes that were reported as skipped during change application.
This method calculates and updates the session statistics contained in the ISyncSessionState object that was passed to IChangeApplicationServices::Initialize.
The updated destination knowledge returned in ppUpdatedDestinationKnowledge must replace the current knowledge of the destination replica.
Note
When the updated destination knowledge is calculated, any changes that the destination provider did not reported as successfully applied by calling IChangeApplicationServices::ReportItemChangeApplied or IChangeApplicationServices::ReportChangeUnitChangeApplied are treated as having failed.