Share via


ISaveChangeWithChangeUnitsContext::SetRecoverableErrorOnChangeUnit

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

  • SYNC_E_ON_CREATE_MUST_FAIL_ENTIRE_ITEM when the save action that is specified for the change is SSA_CREATE. In this situation, the entire item creation fails.

Remarks

When this method is called, an IChangeUnitException object is added to the learned knowledge. 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