IChangeApplicationServices::BeginChangeApplication
开始处理一组变更。
语法
HRESULT BeginChangeApplication(
ISyncKnowledge * pDestinationKnowledge,
IForgottenKnowledge * pDestinationForgottenKnowledge,
ISyncFilterInfo * pFilterInfo,
ISyncCallback * pSyncCallback,
IUnknown * pSourceDataRetriever,
IUnknown * pDestinationDataRetriever);
参数
pDestinationKnowledge
[in] 目标副本的当前知识。pDestinationForgottenKnowledge
[in, unique] 目标副本的当前遗忘知识。可以为 NULL。pFilterInfo
[in, unique] 有关目标提供程序使用的筛选器的信息。可以为 NULL。pSyncCallback
[in, unique] 将接收有关变更应用事件的通知的回调。可以为 NULL。pSourceDataRetriever
[in] 一个可用于从源副本中检索项数据的对象。pDestinationDataRetriever
[in] 一个可用于从目标副本中检索项数据的对象。
返回值
S_OK。
E_OUTOFMEMORY。
E_POINTER。
如果任何指定的知识对象的 ID 格式架构与初始化此对象时指定的 ID 格式架构不匹配,则返回值为 SYNC_E_ID_FORMAT_MISMATCH。
如果尚未初始化此对象或者变更应用已开始但未在另一组变更开始时结束,则返回值为 SYNC_E_INVALID_OPERATION。
注释
通常对通过目标提供程序的 IKnowledgeSyncProvider::ProcessChangeBatch 方法接收的每个变更批调用一次此方法。
必须先调用此方法,然后才能设置或计算知识,或者应用或报告变更。