Sync Framework Error Codes

This topic lists new error codes that are defined by Sync Framework. Sync Framework uses the standard IErrorInfo mechanism to report the error description and the source of the failure.

Remarks

Error code Description

SYNC_E_ID_FORMAT_MISMATCH

The ID format does not match the format that is specified by the ID format schema.

SYNC_E_INVALID_OPERATION

The operation is not valid for the current state of the object.

SYNC_E_REPLICA_NOT_FOUND

The specified replica cannot be found in the specified IReplicaKeyMap object.

SYNC_E_CHANGE_COUNT_MISMATCH

The number of destination item versions does not match the number of source item changes.

SYNC_E_CHANGE_UNIT_COUNT_MISMATCH

The number of change units in a destination item version does not match the number of change units in the corresponding source item change.

SYNC_E_KNOWLEDGE_DECREASED

The knowledge unexpectedly contains fewer items than it did previously.

SYNC_E_CHANGE_NOT_IN_KNOWLEDGE

The specified change version is not contained in the specified knowledge object.

SYNC_E_ITEM_MUST_EXIST

A synchronization provider reports that an item does not exist in its replica, although the creation version of the item is contained in the knowledge from that provider.

SYNC_E_HAS_NO_DATA

Item data does not exist for the specified item.

SYNC_E_CHANGE_NEEDS_KNOWLEDGE

The specified item change object does not contain a made-with knowledge object.

SYNC_E_RANGE_OUT_OF_ORDER

A range of items is not in the expected order, or a range override is specified incorrectly.

SYNC_E_NOT_EXPECTED_CHANGE

The order of destination item versions or change unit versions differs from the order of source item changes or change unit changes.

SYNC_E_DESERIALIZATION

Serialization or deserialization cannot be performed.

SYNC_E_SINGLE_RANGE_ONLY

An ISyncFullEnumerationChangeBatch object contains more than one group of changes.

SYNC_E_ITEM_HAS_CHANGE_UNITS

The attempted operation is not valid because the specified item has change units.

SYNC_E_ITEM_HAS_NO_CHANGE_UNITS

The attempted operation is not valid because the specified item does not have change units.

SYNC_E_ITEM_HAS_NO_VERSION_DATA

The attempted operation is not valid because the specified item has no version data.

SYNC_E_OBJECT_NEEDS_STATE

A required ISyncSessionState object is not specified.

SYNC_E_INVALID_VERSION

The specified version is not supported.

SYNC_E_DUPLICATE_ITEM

An entry already exists in the specified replica key map for the specified replica ID or replica key.

SYNC_E_INVALID_ORDER_FOR_VECTOR_ELEMENTS

The specified clock vector elements are in the wrong order.

SYNC_E_INVALID_SYNC_TIME

The specified SYNC_TIME value is not valid.

SYNC_E_INCOMPLETE_REPLICA_KEY_MAP

The specified replica key map is incomplete.

SYNC_E_INVALID_REPLICA_KEY

A clock vector element has a replica key that is not in the replica key map.

SYNC_E_NEGATIVE_RANGE_EXCEPTION

An IRangeException object that is used to build a knowledge object contains an IClockVector object that does not contain the clock vector contained in the IKnowledgeBuilder object.

SYNC_E_BATCH_NEEDS_KNOWLEDGE

A change batch object does not contain a learned knowledge object

SYNC_E_INTERNAL_ERROR

An internal error occurred in Sync Framework. This error code supports the Sync Framework infrastructure and should not be used directly from your code.

SYNC_E_CHANGE_BATCH_IS_READ_ONLY

The change batch object is read-only.

SYNC_E_DATA_MODIFIED_CONCURRENTLY

Item data changed unexpectedly.

SYNC_E_ON_CREATE_MUST_FAIL_ENTIRE_ITEM

A recoverable error cannot be recorded for a change unit change when the change represents an item creation.

SYNC_E_FILTER_NOT_SUPPORTED

The source provider does not support the specified filter.

SYNC_E_LOAD_CONFLICT_DATA_FAILED

The requested data could not be loaded. This occurs when a recoverable error is set while data is being loaded, or if data conversion fails. Possible resolutions include deferring the conflict or resolving the conflict without change data.

SYNC_E_INVALID_SERIALIZATION_VERSION

The specified serialization version is not supported or cannot be used.

SYNC_E_MARKER_MISMATCH

The specified marker is invalid.

SYNC_E_FORGOTTEN_KNOWLEDGE_NOT_CONTAINED

A forgotten knowledge object is not contained by its associated knowledge object.

SYNC_E_ACTIVE_CHANGE_APPLICATION_CONTEXT

The operation cannot be completed because an active change application context already exists.

SYNC_E_ITEM_LIST_FILTERED_FULL_ENUMERATION_NOT_SUPPORTED

Recovery synchronization cannot be performed when an item filter is in use.

SYNC_E_FULL_ENUMERATION_MUST_BE_USED

A change was specified as a recovery synchronization change, but the change application service is not in recovery synchronization mode.

SYNC_E_BATCH_NEEDS_FILTER_FORGOTTEN_KNOWLEDGE

A required filter forgotten knowledge is not set in the change batch.

SYNC_E_CONSTRAINT_CONFLICT_NOT_ALLOWED

A constraint conflict cannot be reported while processing the current save action.

SYNC_E_SOURCE_DOES_NOT_TRACK_FILTER

The source provider does not track the specified filter.

HRESULT_FROM_WIN32(ERROR_MORE_DATA)

The specified buffer is not large enough to accommodate the return value.

Requirements

Header: Synchronizationerrors.h

See Also

Concepts

Sync Framework Core Components