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。