IChangeApplicationServices::ReportItemChangeApplied
通知變更套用服務,表示項目變更已經成功套用至目的地複寫。
HRESULT ReportItemChangeApplied(
ISyncChange * pChange);
參數
- pChange
[in] 已成功套用至目的地複寫的項目變更。
傳回值
S_OK。
E_OUTOFMEMORY。
E_POINTER。
如果 IChangeApplicationContext 物件已經處於使用中狀態,則為 SYNC_E_ACTIVE_CHANGE_APPLICATION_CONTEXT。您必須處理使用中的 IChangeApplicationContext 物件,直到其 IChangeApplicationContext::GetChangeApplicationAction 方法傳回 CAA_FINISHED 為止,然後才能處理其他變更。
如果 pChange 不包含建立方式知識,則為 SYNC_E_CHANGE_NEEDS_KNOWLEDGE。
當指定之識別碼的格式與初始化此物件時所指定的識別碼格式結構描述不符時,則為 SYNC_E_ID_FORMAT_MISMATCH。
如果尚未啟動變更批次的變更套用、pChange 已經報告成套用成功或發生衝突,或者 pChange 包含先前已透過呼叫 IChangeApplicationServices::ReportRecoverableErrorOnChangeUnitChange 報告成失敗的變更單位,則為 SYNC_E_INVALID_OPERATION。
如果此變更中學習到的知識不包含學習到的被遺忘知識,則為 SYNC_E_FORGOTTEN_KNOWLEDGE_NOT_CONTAINED。
備註
當 pChange 包含變更單位時,所有變更單位都會報告成套用成功,但是發生衝突的變更單位除外。
當 pChange 包含先前已報告成失敗的變更單位時,這個方法就會傳回錯誤。若要報告已套用成功但先前報告成失敗的變更單位,請針對每個變更單位呼叫 IChangeApplicationServices::ReportChangeUnitChangeApplied。
這個方法會引發 ISyncCallback2::OnChangeApplied 事件。