IItemMetadata2::SetMergeWinnerIdOnDeletedItem
Sets the winning ID value of a merge tombstone.
HRESULT SetMergeWinnerIdOnDeletedItem(
const BYTE * pbWinnerId);
Parameters
- pbWinnerId
[in] The item ID used to identify a merged item after the merge occurs. This is also called the winning ID.
Return Value
S_OK.
E_OUTOFMEMORY.
E_POINTER.
SYNC_E_METADATA_INVALID_OPERATION when this item is already marked as deleted.
Remarks
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.