ISaveChangeWithChangeUnitsContext::SetRecoverableErrorOnChangeUnit
表示當這個變更單位的資料已儲存至項目存放區時所發生的可復原錯誤。
HRESULT SetRecoverableErrorOnChangeUnit(
HRESULT hrError,
ISyncChangeUnit * pChangeUnit,
IRecoverableErrorData * pErrorData);
參數
- hrError
[in] 與這項阻礙變更單位資料套用的錯誤關聯的錯誤碼。
- pChangeUnit
[in] 導致錯誤的變更單位變更。
- pErrorData
[in, unique] 有關此錯誤的其他資訊。
傳回值
S_OK
E_INVALIDARG
E_POINTER
SYNC_E_INTERNAL_ERROR
如果針對此變更所指定的儲存動作是 SSA_CREATE，則為 SYNC_E_ON_CREATE_MUST_FAIL_ENTIRE_ITEM。在這種情況下，建立整個項目就會失敗。
備註
呼叫這個方法時，IChangeUnitException 物件會加入至學習到的知識。在同步處理工作階段的持續期間內，將不會再次列舉此變更單位變更。
注意
如果在儲存含有變更單位的新變更時發生錯誤，而此錯誤涉及所有變更單位，就必須呼叫 ISaveChangeContext::SetRecoverableErrorOnChange。
這個方法會更新同步處理範圍的知識。呼叫這個方法之後，請呼叫 ISaveChangeContext::GetKnowledgeForScope 擷取更新過的知識。