ISyncConstraintCallback::OnConstraintConflict

Occurs when a constraint conflict is reported, for collision conflicts when the collision conflict resolution policy is set to CCRP_NONE, and for all non-collision constraint conflicts.

Syntax

HRESULT OnConstraintConflict(
  IConstraintConflict * pConflict);

Parameters

  • pConflict
    [in] Information about the conflict. This includes metadata and item data for the two changes that are in conflict.

Return Value

  • S_OK

  • Application-determined error codes

Remarks

This notification can be used by an application to perform custom conflict resolution for constraint conflicts. To accomplish this, the application inspects and processes the contents of pConflict, and then sets the resolution action for the conflict by calling IConstraintConflict::SetConstraintResolveActionForChange or IConstraintConflict::SetConstraintResolveActionForChangeUnit before it returns from this method.

When the IConstraintConflict::GetConstraintConflictReason method of pConflict returns any value other than CCR_COLLISION, the resolution action must be set to either SCRA_DEFER or SCRA_TRANSFER_AND_DEFER.

See Also

Reference

ISyncConstraintCallback Interface