ISimpleSyncProviderConstraintConflictResolver.ModifyAndInsertRemoteItem Method

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

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

Syntax

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

instance.ModifyAndInsertRemoteItem(itemData, changeUnitsToCreate, recoverableErrorReportingContext, updatedKeyAndVersion)
void ModifyAndInsertRemoteItem (
    Object itemData,
    IEnumerable<SyncId> changeUnitsToCreate,
    RecoverableErrorReportingContext recoverableErrorReportingContext,
    out ItemFieldDictionary updatedKeyAndVersion
)
void ModifyAndInsertRemoteItem (
    Object^ itemData, 
    IEnumerable<SyncId^>^ changeUnitsToCreate, 
    RecoverableErrorReportingContext^ recoverableErrorReportingContext, 
    [OutAttribute] ItemFieldDictionary^% updatedKeyAndVersion
)
void ModifyAndInsertRemoteItem (
    Object itemData, 
    IEnumerable<SyncId> changeUnitsToCreate, 
    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.
  • changeUnitsToCreate
    A collection of SyncId objects that represent the set of change units to create during conflict resolution.
  • 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 created as a result of conflict resolution.

Exceptions

Exception type Condition

SyncRuntimeInternalErrorException

changeUnitsToCreate contained a change unit of unexpected size.

See Also

Reference

ISimpleSyncProviderConstraintConflictResolver Interface
ISimpleSyncProviderConstraintConflictResolver Members
Microsoft.Synchronization.SimpleProviders Namespace