IChangeApplicationServices::ReportItemChangeApplied

通知变更应用服务,项变更已成功应用于目标副本。

语法

HRESULT ReportItemChangeApplied(
  ISyncChange * pChange);

参数

  • pChange
    [in] 已成功应用于目标副本的项变更。

返回值

  • S_OK。

  • E_OUTOFMEMORY。

  • E_POINTER。

  • 如果 IChangeApplicationContext 对象已处于活动状态,则返回值为 SYNC_E_ACTIVE_CHANGE_APPLICATION_CONTEXT。必须先处理活动的 IChangeApplicationContext 对象,直到其 IChangeApplicationContext::GetChangeApplicationAction 方法返回 CAA_FINISHED,然后才能处理另一个变更。

  • 如果 pChange 不包含生成知识,则返回值为 SYNC_E_CHANGE_NEEDS_KNOWLEDGE。

  • 如果指定 ID 的格式与初始化此对象时指定的 ID 格式架构不匹配,则返回值为 SYNC_E_ID_FORMAT_MISMATCH。

  • 在以下情况下,返回值为 SYNC_E_INVALID_OPERATION:未为变更批启动变更应用;或已将 pChange 报告为已成功应用或发生冲突;或 pChange 包含先前已通过调用 IChangeApplicationServices::ReportRecoverableErrorOnChangeUnitChange 报告为已失败的变更单位。

  • 如果变更的已知知识不包含已知的遗忘知识,则返回值为 SYNC_E_FORGOTTEN_KNOWLEDGE_NOT_CONTAINED。

注释

当 pChange 包含变更单位时,所有变更单位都将报告为已成功应用,但发生冲突的变更单位除外。

当 pChange 包含先前报告为已失败的变更单位时,此方法将返回一个错误。若要报告已成功应用的变更单位(先前报告为应用失败),请为每个变更单位调用 IChangeApplicationServices::ReportChangeUnitChangeApplied

此方法将触发 ISyncCallback2::OnChangeApplied 事件。

请参阅

其他资源

IChangeApplicationServices 接口