ChangeApplicationServices.BeginFullEnumerationChangeApplication Method

Begins processing of a set of changes as part of a recovery synchronization.

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

Syntax

'Declaration
Public Sub BeginFullEnumerationChangeApplication ( _
    destinationKnowledge As SyncKnowledge, _
    destinationForgottenKnowledge As ForgottenKnowledge, _
    sourceForgottenDeleteKnowledge As SyncKnowledge, _
    sourceForgottenDeleteForgottenKnowledge As ForgottenKnowledge, _
    filterInfo As FilterInfo, _
    syncCallbacks As SyncCallbacks, _
    sourceDataRetriever As IChangeDataRetriever, _
    destinationDataRetriever As IChangeDataRetriever _
)
'Usage
Dim instance As ChangeApplicationServices
Dim destinationKnowledge As SyncKnowledge
Dim destinationForgottenKnowledge As ForgottenKnowledge
Dim sourceForgottenDeleteKnowledge As SyncKnowledge
Dim sourceForgottenDeleteForgottenKnowledge As ForgottenKnowledge
Dim filterInfo As FilterInfo
Dim syncCallbacks As SyncCallbacks
Dim sourceDataRetriever As IChangeDataRetriever
Dim destinationDataRetriever As IChangeDataRetriever

instance.BeginFullEnumerationChangeApplication(destinationKnowledge, destinationForgottenKnowledge, sourceForgottenDeleteKnowledge, sourceForgottenDeleteForgottenKnowledge, filterInfo, syncCallbacks, sourceDataRetriever, destinationDataRetriever)
public void BeginFullEnumerationChangeApplication (
    SyncKnowledge destinationKnowledge,
    ForgottenKnowledge destinationForgottenKnowledge,
    SyncKnowledge sourceForgottenDeleteKnowledge,
    ForgottenKnowledge sourceForgottenDeleteForgottenKnowledge,
    FilterInfo filterInfo,
    SyncCallbacks syncCallbacks,
    IChangeDataRetriever sourceDataRetriever,
    IChangeDataRetriever destinationDataRetriever
)
public:
void BeginFullEnumerationChangeApplication (
    SyncKnowledge^ destinationKnowledge, 
    ForgottenKnowledge^ destinationForgottenKnowledge, 
    SyncKnowledge^ sourceForgottenDeleteKnowledge, 
    ForgottenKnowledge^ sourceForgottenDeleteForgottenKnowledge, 
    FilterInfo^ filterInfo, 
    SyncCallbacks^ syncCallbacks, 
    IChangeDataRetriever^ sourceDataRetriever, 
    IChangeDataRetriever^ destinationDataRetriever
)
public void BeginFullEnumerationChangeApplication (
    SyncKnowledge destinationKnowledge, 
    ForgottenKnowledge destinationForgottenKnowledge, 
    SyncKnowledge sourceForgottenDeleteKnowledge, 
    ForgottenKnowledge sourceForgottenDeleteForgottenKnowledge, 
    FilterInfo filterInfo, 
    SyncCallbacks syncCallbacks, 
    IChangeDataRetriever sourceDataRetriever, 
    IChangeDataRetriever destinationDataRetriever
)
public function BeginFullEnumerationChangeApplication (
    destinationKnowledge : SyncKnowledge, 
    destinationForgottenKnowledge : ForgottenKnowledge, 
    sourceForgottenDeleteKnowledge : SyncKnowledge, 
    sourceForgottenDeleteForgottenKnowledge : ForgottenKnowledge, 
    filterInfo : FilterInfo, 
    syncCallbacks : SyncCallbacks, 
    sourceDataRetriever : IChangeDataRetriever, 
    destinationDataRetriever : IChangeDataRetriever
)

Parameters

  • destinationKnowledge
    The current knowledge of the destination replica.
  • destinationForgottenKnowledge
    The current forgotten knowledge of the destination replica.
  • sourceForgottenDeleteKnowledge
    The made-with knowledge of the change batch to be processed.
  • sourceForgottenDeleteForgottenKnowledge
    The current forgotten knowledge of the source replica.
  • filterInfo
    Information about filters used by the destination provider. Can be a null reference (Nothing in Visual Basic).
  • syncCallbacks
    Callbacks that will receive notifications about change application events. Can be a null reference (Nothing in Visual Basic).
  • sourceDataRetriever
    An object that can be used to retrieve item data from the source replica.
  • destinationDataRetriever
    An object that can be used to retrieve item data from the destination replica.

Exceptions

Exception type Condition

ArgumentNullException

A required parameter is a null reference (Nothing in Visual Basic).

SyncIdFormatMismatchException

The ID format schema of any of the specified knowledge objects does not match the ID format schema specified when this object was initialized.

SyncInvalidOperationException

The change application was started but not ended on another set of changes.

ItemListFilteredFullEnumerationNotSupportedException

The filterInfo parameter specifies that item filtering is in use. Item filtering cannot be used by the destination provider during recovery synchronization.

Remarks

This method is typically called one time for each batch of changes that is received by the ProcessFullEnumerationChangeBatch method of the destination provider.

This method must be called before knowledge can be set or calculated, or changes applied or reported.

See Also

Reference

ChangeApplicationServices Class
ChangeApplicationServices Members
Microsoft.Synchronization Namespace