IAsynchronousNotifyingChangeApplierTarget::SaveChangeWithChangeUnits

将包含变更单位变更的项变更保存到项存储区中。

备注

此方法现已过时。

HRESULT SaveChangeWithChangeUnits(
  ISyncChange * pChange,
  ISaveChangeWithChangeUnitsContext * pSaveContext);

参数

• pChange
  [in] 要应用的项变更。

• pSaveContext
  [in] 有关要应用的变更的信息。

返回值

• S_OK

• 提供程序确定的错误代码

实施者注意事项

调用 SaveChangeWithChangeUnits 时，提供程序必须执行以下操作之一：

• 从该方法返回成功代码，并稍后调用 IAsynchronousNotifyingChangeApplierTargetCallback::SaveChangeWithChangeUnitsComplete 以报告异步处理已成功完成。

• 从该方法返回成功代码，并稍后调用 IAsynchronousNotifyingChangeApplierTargetCallback::OnError 以报告在异步处理期间出现错误。

• 从该方法返回错误代码。在这种情况下，不应调用 IAsynchronousNotifyingChangeApplierTargetCallback 方法。

如果 pSaveContext 中包含的操作为 SSA_CREATE，则必须成功保存所有变更单位或放弃整个项变更。如果可保存某些变更单位但无法保存其他变更单位，则会导致数据损坏。

当调用 ISaveChangeWithChangeUnitsContext::SetRecoverableErrorOnChangeUnit 且 pSaveContext 为 SSA_CREATE 时，SetRecoverableErrorOnChangeUnit 将返回 SYNC_E_ON_CREATE_MUST_FAIL_ENTIRE_ITEM。

请参阅

参考

IAsynchronousNotifyingChangeApplierTarget 接口
IAsynchronousNotifyingChangeApplierTargetCallback 接口