ISynchronousNotifyingChangeApplier::ApplyFullEnumerationChanges
Performs conflict detection, conflict handling, and change application for a batch of changes as part of a full enumeration.
Syntax
HRESULT ApplyFullEnumerationChanges(
CONFLICT_RESOLUTION_POLICY resolutionPolicy,
ISyncFullEnumerationChangeBatch * pSourceChanges,
IUnknown * pUnkDataRetriever,
IEnumSyncChanges * pDestinationVersions,
ISyncKnowledge * pDestinationKnowledge,
IForgottenKnowledge * pDestinationForgottenKnowledge,
ISynchronousNotifyingChangeApplierTarget * pChangeApplierTarget,
ISyncSessionState * pSessionState,
ISyncCallback * pCallback);
Parameters
Parameter |
Description |
resolutionPolicy |
[in] The policy to use for resolving conflicts. |
pSourceChanges |
[in] The batch of changes from the source provider. |
pUnkDataRetriever |
[in] An object that can be used to retrieve item data from the source replica. |
pDestinationVersions |
[in] A batch of changes that contains the versions of items that are stored in the destination replica. These items correspond to the items in pSourceChanges. |
pDestinationKnowledge |
[in] The knowledge of the destination replica. |
pDestinationForgottenKnowledge |
[in] The forgotten knowledge of the destination replica. |
pChangeApplierTarget |
[in] The object that will be called to save changes and conflicts. |
pSessionState |
[in, unique] State information about the current session. |
pCallback |
[in, unique] Callbacks that will receive notifications about change application events. |
Return Value
S_OK
E_POINTER
SYNC_E_OBJECT_NEEDS_STATE
SYNC_E_INTERNAL_ERROR
SYNC_E_CHANGE_COUNT_MISMATCH
SYNC_E_CHANGE_NEEDS_KNOWLEDGE
SYNC_E_ITEM_HAS_NO_CHANGE_UNITS
SYNC_E_CHANGE_NOT_IN_KNOWLEDGE
SYNC_E_CHANGE_UNIT_COUNT_MISMATCH
SYNC_E_NOT_EXPECTED_CHANGE
SYNC_E_ITEM_MUST_EXIST
SYNC_E_ID_FORMAT_MISMATCH
SYNC_E_BATCH_NEEDS_KNOWLEDGE
SYNC_E_KNOWLEDGE_DECREASED
Remarks
This method detects conflicts that occur between the changes that are sent in pSourceChanges and the corresponding items in the destination replica. This method resolves any conflicts according to the policy that is specified by resolutionPolicy. If it is necessary, this method then calls methods on pChangeApplierTarget to save changes to the destination replica and to save unresolved conflicts.