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