IChangeApplicationServices::BeginChangeApplication
Begins processing of a set of changes.
HRESULT BeginChangeApplication(
ISyncKnowledge * pDestinationKnowledge,
IForgottenKnowledge * pDestinationForgottenKnowledge,
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. Can be NULL.
- 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.
Remarks
This method is typically called one time for each batch of changes that is received by the IKnowledgeSyncProvider::ProcessChangeBatch method of the destination provider.
This method must be called before knowledge can be set or calculated, or changes applied or reported.