Share via

ISaveChangeWithChangeUnitsContext::SetRecoverableErrorOnChangeUnit

  • Article

Indicates that a recoverable error occurred when data for this change unit was saved to the item store.

HRESULT SetRecoverableErrorOnChangeUnit(
  HRESULT hrError,
  ISyncChangeUnit * pChangeUnit,
  IRecoverableErrorData * pErrorData);

Parameters

  • hrError
    [in] The error code that is associated with the error that prevented the change unit data from being applied.
  • pChangeUnit
    [in] The change unit change that caused the error.
  • pErrorData
    [in, unique] Additional information about the error.

Return Value

  • S_OK

  • E_INVALIDARG

  • E_POINTER

  • SYNC_E_INTERNAL_ERROR

Remarks

When this method is called, an IChangeUnitException object is added to the learned knowledge; and the change unit change will not be enumerated again for the duration of the synchronization session.

Note

If an error occurs when a new change with change units is being saved and the error involves all change units, ISaveChangeContext::SetRecoverableErrorOnChange must be called.

This method updates the knowledge for the synchronization scope. After this method is called, call ISaveChangeContext::GetKnowledgeForScope to retrieve the updated knowledge.

See Also

Reference

ISaveChangeWithChangeUnitsContext Interface