ChangeApplicationServices::BeginFullEnumerationChangeApplication Method
Begins processing of a set of changes as part of a recovery synchronization.
Assembly: Microsoft.Synchronization (in Microsoft.Synchronization.dll)
public: void BeginFullEnumerationChangeApplication( SyncKnowledge^ destinationKnowledge, ForgottenKnowledge^ destinationForgottenKnowledge, SyncKnowledge^ sourceForgottenDeleteKnowledge, ForgottenKnowledge^ sourceForgottenDeleteForgottenKnowledge, FilterInfo^ filterInfo, SyncCallbacks^ syncCallbacks, IChangeDataRetriever^ sourceDataRetriever, IChangeDataRetriever^ destinationDataRetriever )
Parameters
- destinationKnowledge
- Type: Microsoft.Synchronization::SyncKnowledge
The current knowledge of the destination replica.
- destinationForgottenKnowledge
- Type: Microsoft.Synchronization::ForgottenKnowledge
The current forgotten knowledge of the destination replica.
- sourceForgottenDeleteKnowledge
- Type: Microsoft.Synchronization::SyncKnowledge
The made-with knowledge of the change batch to be processed.
- sourceForgottenDeleteForgottenKnowledge
- Type: Microsoft.Synchronization::ForgottenKnowledge
The current forgotten knowledge of the source replica.
- filterInfo
- Type: Microsoft.Synchronization::FilterInfo
Information about filters used by the destination provider. Can be a nullptr.
- syncCallbacks
- Type: Microsoft.Synchronization::SyncCallbacks
Callbacks that will receive notifications about change application events. Can be a nullptr.
- sourceDataRetriever
- Type: Microsoft.Synchronization::IChangeDataRetriever
An object that can be used to retrieve item data from the source replica.
- destinationDataRetriever
- Type: Microsoft.Synchronization::IChangeDataRetriever
An object that can be used to retrieve item data from the destination replica.
| Exception | Condition |
|---|---|
| ArgumentNullException | A required parameter is a nullptr. |
| 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. |
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.