IChangeApplicationServices::EndFullEnumerationChangeApplication
結束處理一組變更 (復原同步處理的一部分)。
HRESULT EndFullEnumerationChangeApplication(
ISyncKnowledge * pBatchLearnedKnowledge,
IForgottenKnowledge * pBatchLearnedForgottenKnowledge,
ISyncKnowledge ** ppUpdatedDestinationKnowledge,
IForgottenKnowledge ** ppUpdatedDestinationForgottenKnowledge);
參數
- pBatchLearnedKnowledge
[in] 變更批次中學習到的知識。
- pBatchLearnedForgottenKnowledge
[in] 變更批次中學習到的被遺忘知識。
- ppUpdatedDestinationKnowledge
[out] 根據已套用或略過的變更,傳回更新的目的地知識。
- ppUpdatedDestinationForgottenKnowledge
[out] 根據已套用或略過的變更,傳回更新的目的地被遺忘知識。
傳回值
S_OK。
E_OUTOFMEMORY。
E_POINTER。
當 pBatchLearnedKnowledge 的識別碼格式結構描述與初始化此物件時所指定的識別碼格式結構描述不符時,為 SYNC_E_ID_FORMAT_MISMATCH。
當此物件尚未初始化時,或未啟動變更應用程式時,則為 SYNC_E_INVALID_OPERATION。
備註
這個方法會修改變更批次中學習到的知識 (由 pBatchLearnedKnowledge 指定) 和變更批次中學習到的被遺忘知識 (由 pBatchLearnedForgottenKnowledge 指定),以便排除報告成在變更應用程式期間略過的任何變更。
這個方法計算並更新的工作階段統計資料包含在已傳遞至 IChangeApplicationServices::Initialize 的 ISyncSessionState 物件。
ppUpdatedDestinationKnowledge 中傳回的更新目的地知識和 ppUpdatedDestinationForgottenKnowledge 中傳回的更新目的地被遺忘知識必須取代目的地複寫的目前知識和被遺忘知識。
注意
計算更新的目的地知識時,目的地提供者並未透過呼叫 IChangeApplicationServices::ReportItemChangeApplied 或 IChangeApplicationServices::ReportChangeUnitChangeApplied 報告成功套用的任何變更都會被視為已失敗。