IAsyncErrorNotify::OnError メソッド (comsvcs.h)

  • [アーティクル]

非同期バッチ作業でエラーが発生したときに COM+ によって呼び出されます。

構文

HRESULT OnError(
  [in] HRESULT hr
);

パラメーター

[in] hr

バッチ作業が非同期的に実行されている間に発生したエラーの HRESULT 値。

戻り値

このメソッドは、E_INVALIDARG、E_OUTOFMEMORY、E_FAIL、S_OKの標準戻り値を返すことができます。

注釈

バッチ作業が非同期的に実行されているときに発生するエラーを適切に処理するには、このメソッドを実装する必要があります。 プロセスは回復不可能なエラーで終了 (FailFast) するため、このメソッドを使用しないと、非同期バッチ作業でエラーが発生したタイミングを知る方法はありません。 このメソッドが戻り値としてエラーを返すと、プロセスも終了します。

バッチ処理自体は IServiceCall::OnCall に実装され、CoCreateActivity の呼び出しから返された IServiceActivity ポインターを使用して IServiceActivity::AsyncCall を呼び出すことによって非同期的に実行されます。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー comsvcs.h

こちらもご覧ください

IAsyncErrorNotify