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

  • SYNC_E_ON_CREATE_MUST_FAIL_ENTIRE_ITEM (変更に指定された保存操作が SSA_CREATE の場合。この場合、項目全体の作成が失敗します。)

説明

このメソッドが呼び出されると、学習したナレッジに IChangeUnitException オブジェクトが追加されます。同期セッションの実行中は、変更単位の変更が再度列挙されることはありません。

注意

変更単位に関連する新しい変更を保存するときにエラーが発生し、そのエラーにすべての変更単位が含まれる場合は、ISaveChangeContext::SetRecoverableErrorOnChange を呼び出す必要があります。

このメソッドは、同期スコープのナレッジを更新します。このメソッドを呼び出した後、ISaveChangeContext::GetKnowledgeForScope を呼び出して、更新されたナレッジを取得します。

関連項目

その他の技術情報

ISaveChangeWithChangeUnitsContext インターフェイス