共用方式為


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 介面