ISyncChangeBatch2::AddMergeTombstoneMetadataToGroup
Adds the specified merge tombstone to the group that is currently open.
S_OK.
E_POINTER.
SYNC_E_CHANGE_BATCH_IS_READ_ONLY when the ISyncChangeBatch2 object has been sent to a change applier or to the synchronization session, or when the object was created by using IProviderSyncServices::DeserializeChangeBatch or IProviderSyncServices::DeserializeFullEnumerationChangeBatch.
SYNC_E_INVALID_OPERATION when no group is open or an empty group was previously added to the batch.
SYNC_E_RANGE_OUT_OF_ORDER when an ordered group is open and pbItemId is less than the item ID of the previous item that was added to the group, or less than the item ID that was specified when the group was opened.
A merge tombstone is created when a constraint conflict is resolved by merging the two items in conflict. When a constraint conflict is resolved by merging, the smaller of the item IDs is chosen as the winning item ID and the larger is the losing item ID. The winning item ID is used to identify the merged item. The merge tombstone tracks that the losing item ID identifies the same item as the winning item ID in the synchronization community. The metadata for a merge tombstone is the same as that for a deleted item tombstone, with the addition of the winning item ID.