ISimpleSyncProviderConstraintConflictResolver.ModifyAndUpdateRemoteItem Method

When overridden in a derived class, renames the remote item so that it no longer conflicts with the local item name and updates the remote item in the local replica.

Namespace: Microsoft.Synchronization.SimpleProviders
Assembly: Microsoft.Synchronization.SimpleProviders (in microsoft.synchronization.simpleproviders.dll)

Syntax

'Declaration
Sub ModifyAndUpdateRemoteItem ( _
    itemData As Object, _
    changeUnitsToUpdate As IEnumerable(Of SyncId), _
    keyAndExpectedVersion As ItemFieldDictionary, _
    recoverableErrorReportingContext As RecoverableErrorReportingContext, _
    <OutAttribute> ByRef updatedKeyAndVersion As ItemFieldDictionary _
)
'Usage
Dim instance As ISimpleSyncProviderConstraintConflictResolver
Dim itemData As Object
Dim changeUnitsToUpdate As IEnumerable(Of SyncId)
Dim keyAndExpectedVersion As ItemFieldDictionary
Dim recoverableErrorReportingContext As RecoverableErrorReportingContext
Dim updatedKeyAndVersion As ItemFieldDictionary

instance.ModifyAndUpdateRemoteItem(itemData, changeUnitsToUpdate, keyAndExpectedVersion, recoverableErrorReportingContext, updatedKeyAndVersion)
void ModifyAndUpdateRemoteItem (
    Object itemData,
    IEnumerable<SyncId> changeUnitsToUpdate,
    ItemFieldDictionary keyAndExpectedVersion,
    RecoverableErrorReportingContext recoverableErrorReportingContext,
    out ItemFieldDictionary updatedKeyAndVersion
)
void ModifyAndUpdateRemoteItem (
    Object^ itemData, 
    IEnumerable<SyncId^>^ changeUnitsToUpdate, 
    ItemFieldDictionary^ keyAndExpectedVersion, 
    RecoverableErrorReportingContext^ recoverableErrorReportingContext, 
    [OutAttribute] ItemFieldDictionary^% updatedKeyAndVersion
)
void ModifyAndUpdateRemoteItem (
    Object itemData, 
    IEnumerable<SyncId> changeUnitsToUpdate, 
    ItemFieldDictionary keyAndExpectedVersion, 
    RecoverableErrorReportingContext recoverableErrorReportingContext, 
    /** @attribute OutAttribute() */ /** @ref */ ItemFieldDictionary updatedKeyAndVersion
)
JScript does not support passing value-type arguments by reference.

Parameters

  • itemData
    Data for the item in a provider-specific format.
  • changeUnitsToUpdate
    A collection of SyncId objects that represent the set of change units to update during conflict resolution.
  • keyAndExpectedVersion
    The key and version properties of the item that is in conflict.
  • recoverableErrorReportingContext
    A RecoverableErrorReportingContext object that is used to report recoverable errors that occur during attempts to resolve a conflict.
  • updatedKeyAndVersion
    Returns the key and version properties that were modified as a result of conflict resolution.

Exceptions

Exception type Condition

SyncRuntimeInternalErrorException

changeUnitsToUpdate contained a change unit of unexpected size.

See Also

Reference

ISimpleSyncProviderConstraintConflictResolver Interface
ISimpleSyncProviderConstraintConflictResolver Members
Microsoft.Synchronization.SimpleProviders Namespace