通过

ISimpleSyncProvider::UpdateItem

  • 项目
HRESULT UpdateItem(
  IUnknown *pItemData,
  const CHANGE_UNIT_SET *pChangeUnitsToUpdate,
  const ITEM_FIELDS *pKeyAndExpectedVersionInfo,
  IRecoverableErrorCallback *pRecoverableErrorCallback,
  ITEM_FIELDS **ppUpdatedKeyAndVersionInfo,
  BOOL *pfCommitKnowledgeAfterThisItem);

参数

  • pItemData
    [in] 特定于提供程序的格式的项数据。
  • pChangeUnitsToUpdate
    [in, unique] 一个包含要为某一项更新的变更单位的 CHANGE_UNIT_SET 对象。如果未指定任何变更单位，该参数应为 Null（非空）。

  • pKeyAndExpectedVersionInfo
    [in] 要更新的项的键和预期版本属性。

    提供程序必须执行开放式并发检查，以便确认目标上的项的版本是否与 pKeyAndExpectedVersionInfo 中找到的值相对应。如果此检查失败，提供程序应报告一个可恢复错误。

  • pRecoverableErrorCallback
    [in] 一个 IRecoverableErrorCallback 对象，该对象包含在更新项的过程中出现可恢复错误时可以调用的方法。
  • ppUpdatedKeyAndVersionInfo
    [out] 返回更新项的键和更新的版本属性。如果返回值无效，则 Sync Framework 运行时终止该会话。
  • pfCommitKnowledgeAfterThisItem
    [out] 返回一个值，指示在完成对指定项的处理后 Sync Framework 运行时是否应将知识提交到元数据存储区。

返回值

  • S_OK

请参阅

参考

ISimpleSyncProvider 接口