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