Share via


ISimpleSyncProvider::InsertItem

Called by the Sync Framework runtime to insert an item into the destination store.

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

Parameters

  • pItemData
    [in] Data for the item in provider-specific format.
  • pChangeUnitsToCreate
    [in, unique] A CHANGE_UNIT_SET object that contains the change units to insert for an item. The parameter should be null (not empty) if no change units are specified.
  • pRecoverableErrorCallback
    [in] An IRecoverableErrorCallback object that contains methods that can be called if a recoverable error occurs during an item insert.
  • ppNewKeyAndVersionInfo
    [out] Returns the key and updated version properties of the item to be inserted. If the return value is not valid, the Sync Framework runtime ends the session.
  • pfCommitKnowledgeAfterThisItem
    [out] Returns whether the Sync Framework runtime should commit knowledge to the metadata store after processing is complete for the specified item.

Return Value

  • S_OK

See Also

Reference

ISimpleSyncProvider Interface