Share via


IChangeApplicationServices::GetUpdatedDestinationKnowledge

Gets the updated destination knowledge that contains all of the changes that have been applied so far.

Syntax

HRESULT GetUpdatedDestinationKnowledge(
  ISyncKnowledge ** ppUpdatedDestinationKnowledge,
  IForgottenKnowledge ** ppUpdatedDestinationForgottenKnowledge);

Parameters

  • ppUpdatedDestinationKnowledge
    [out] Returns the updated destination knowledge that contains all of the changes that have been applied so far.

  • ppUpdatedDestinationForgottenKnowledge
    [out, unique] Returns the updated destination forgotten knowledge that contains all of the changes that have been applied so far. Can be NULL when the set of changes to be applied is not part of a recovery synchronization. Otherwise, cannot be NULL.

Return Value

  • S_OK.

  • E_OUTOFMEMORY.

  • E_POINTER when ppUpdatedDestinationKnowledge is NULL, or when ppUpdatedDestinationForgottenKnowledge is NULL and the set of changes to apply is part of a recovery synchronization.

  • SYNC_E_FULL_ENUMERATION_MUST_BE_USED when the set of changes is part of a recovery synchronization but IChangeApplicationServices::BeginChangeApplication was used to start change application instead of IChangeApplicationServices::BeginFullEnumerationChangeApplication.

  • SYNC_E_INVALID_OPERATION when this object has not been initialized, or when change application was not started.

Remarks

The updated knowledge objects that are returned by this method include only changes that the destination provider reported as successfully applied by calling IChangeApplicationServices::ReportItemChangeApplied or IChangeApplicationServices::ReportChangeUnitChangeApplied.

See Also

Reference

IChangeApplicationServices Interface