IChangeApplicationServices::BeginFullEnumerationChangeApplication
开始处理作为恢复同步组成部分的一组变更。
语法
HRESULT BeginFullEnumerationChangeApplication(
ISyncKnowledge * pDestinationKnowledge,
IForgottenKnowledge * pDestinationForgottenKnowledge,
ISyncKnowledge * pSourceKnowledge,
IForgottenKnowledge * pSourceForgottenKnowledge,
ISyncFilterInfo * pFilterInfo,
ISyncCallback * pSyncCallback,
IUnknown * pSourceDataRetriever,
IUnknown * pDestinationDataRetriever);
参数
pDestinationKnowledge
[in] 目标副本的当前知识。pDestinationForgottenKnowledge
[in, unique] 目标副本的当前遗忘知识。pSourceKnowledge
[in] 要处理的变更批的生成知识。pSourceForgottenKnowledge
[in] 源副本的当前遗忘知识。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。
如果 pFilterInfo 参数指定正在使用项筛选,则返回值为 SYNC_E_ITEM_LIST_FILTERED_FULL_ENUMERATION_NOT_SUPPORTED。在恢复同步期间,目标提供程序不能使用项筛选。
注释
通常对通过目标提供程序的 IKnowledgeSyncProvider::ProcessFullEnumerationChangeBatch 方法接收的每批变更调用一次此方法。
必须先调用此方法,然后才能设置或计算知识,或者应用或报告变更。