ReplicaMetadata.FindItemMetadataByMergeWinnerId Method

When overridden in a derived class, returns a list of item metadata entries that represent merge tombstones that have the specified value for their merge winner ID property.

Namespace: Microsoft.Synchronization.MetadataStorage
Assembly: Microsoft.Synchronization.MetadataStorage (in microsoft.synchronization.metadatastorage.dll)

Syntax

'Declaration
Public MustOverride Function FindItemMetadataByMergeWinnerId ( _
    globalId As SyncId _
) As IEnumerable(Of ItemMetadata)
'Usage
Dim instance As ReplicaMetadata
Dim globalId As SyncId
Dim returnValue As IEnumerable(Of ItemMetadata)

returnValue = instance.FindItemMetadataByMergeWinnerId(globalId)
public abstract IEnumerable<ItemMetadata> FindItemMetadataByMergeWinnerId (
    SyncId globalId
)
public:
virtual IEnumerable<ItemMetadata^>^ FindItemMetadataByMergeWinnerId (
    SyncId^ globalId
) abstract
public abstract IEnumerable<ItemMetadata> FindItemMetadataByMergeWinnerId (
    SyncId globalId
)
public abstract function FindItemMetadataByMergeWinnerId (
    globalId : SyncId
) : IEnumerable<ItemMetadata>

Parameters

  • globalId
    Merge tombstones in the returned list will have this value for their merge winner ID property.

Return Value

A list of item metadata entries that represent merge tombstones that have the specified value for their merge winner ID property. An empty collection is returned when no items exist.

Exceptions

Exception type Condition

ArgumentNullException

globalId is a null reference (Nothing in Visual Basic).

SyncIdFormatMismatchException

globalId is not of the correct format.

Remarks

A merge tombstone represents an item that was merged into another item to resolve a constraint conflict. The merge winner ID is the item ID of the item that contains the merged data.

See Also

Reference

ReplicaMetadata Class
ReplicaMetadata Members
Microsoft.Synchronization.MetadataStorage Namespace