IChangeApplicationServices::BeginFullEnumerationChangeApplication
Begins processing of a set of changes as part of a recovery synchronization.
HRESULT BeginFullEnumerationChangeApplication(
ISyncKnowledge * pDestinationKnowledge,
IForgottenKnowledge * pDestinationForgottenKnowledge,
ISyncKnowledge * pSourceKnowledge,
IForgottenKnowledge * pSourceForgottenKnowledge,
ISyncFilterInfo * pFilterInfo,
ISyncCallback * pSyncCallback,
IUnknown * pSourceDataRetriever,
IUnknown * pDestinationDataRetriever);
Parameters
- pDestinationKnowledge
[in] The current knowledge of the destination replica.
- pDestinationForgottenKnowledge
[in, unique] The current forgotten knowledge of the destination replica.
- pSourceKnowledge
[in] The made-with knowledge of the change batch to be processed.
- pSourceForgottenKnowledge
[in] The current forgotten knowledge of the source replica.
- pFilterInfo
[in, unique] Information about filters used by the destination provider. Can be NULL.
- pSyncCallback
[in, unique] Callbacks that will receive notifications about change application events. Can be NULL.
- pSourceDataRetriever
[in] An object that can be used to retrieve item data from the source replica.
- pDestinationDataRetriever
[in] An object that can be used to retrieve item data from the destination replica.
Return Value
S_OK.
E_OUTOFMEMORY.
E_POINTER.
SYNC_E_ID_FORMAT_MISMATCH when the ID format schema of any of the specified knowledge objects does not match the ID format schema specified when this object was initialized.
SYNC_E_INVALID_OPERATION when this object has not been initialized, or when change application was started but not ended on another set of changes.
SYNC_E_ITEM_LIST_FILTERED_FULL_ENUMERATION_NOT_SUPPORTED the pFilterInfo 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 IKnowledgeSyncProvider::ProcessFullEnumerationChangeBatch method of the destination provider.
This method must be called before knowledge can be set or calculated, or changes applied or reported.