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