ISimpleSyncProvider::InsertItem

由 Sync Framework 运行时调用以便将某一项插入到目标存储区中。

HRESULT InsertItem(
  IUnknown *pItemData,
  const CHANGE_UNIT_SET *pChangeUnitsToCreate,
  IRecoverableErrorCallback *pRecoverableErrorCallback,
  ITEM_FIELDS **ppNewKeyAndVersionInfo,
  BOOL *pfCommitKnowledgeAfterThisItem);

参数

  • pItemData
    [in] 特定于提供程序的格式的项数据。
  • pChangeUnitsToCreate
    [in, unique] 一个包含要为某一项插入的变更单位的 CHANGE_UNIT_SET 对象。如果未指定任何变更单位,该参数应为 Null(非空)。
  • pRecoverableErrorCallback
    [in] 一个 IRecoverableErrorCallback 对象,该对象包含在插入项的过程中出现可恢复错误时可以调用的方法。
  • ppNewKeyAndVersionInfo
    [out] 返回要插入的项的键和更新的版本属性。如果返回值无效,则 Sync Framework 运行时将结束该会话。
  • pfCommitKnowledgeAfterThisItem
    [out] 返回一个值,指示在完成对指定项的处理后 Sync Framework 运行时是否应将知识提交到元数据存储区。

返回值

  • S_OK

请参阅

参考

ISimpleSyncProvider 接口