方法: HRESULT と例外をマップする

COM メソッドは、HRESULT を返すことによってエラーを報告します。.NETメソッドは、例外をスローすることによってそれらを報告します。 ランタイムは、2 つの間の遷移を処理します。 .NET内の各例外クラスは HRESULT にマップされます。

ユーザー定義の例外クラスは、適切な HRESULT を指定できます。 これらの例外クラスは、例外オブジェクトに HResult フィールドを設定することによって、例外が生成されたときに返される HRESULT を動的に変更できます。 例外に関する追加情報は、アンマネージ プロセスの.NET オブジェクトに実装されるIErrorInfo インターフェイスを介してクライアントに提供されます。

System.Exception拡張するクラスを作成する場合は、構築時に HRESULT フィールドを設定する必要があります。 それ以外の場合、基本クラスは HRESULT 値を割り当てます。 新しい例外クラスを既存の HRESULT にマップするには、例外のコンストラクターで値を指定します。

スレッドにHRESULTが存在する場合、ランタイムはIErrorInfoを無視することがあります。 この動作は、 HRESULT と IErrorInfo が同じエラーを表していない場合に発生する可能性があります。

新しい例外クラスを作成して HRESULT にマップするには

1. 次のコードを使用して、 NoAccessException という新しい例外クラスを作成し、HRESULT E_ACCESSDENIEDにマップします。

   Class NoAccessException : public ApplicationException
   {
       NoAccessException () {
       HResult = E_ACCESSDENIED;
   }
   }
   CMyClass::MethodThatThrows
   {
   throw new NoAccessException();
   }
   

マネージド コードとアンマネージド コードの両方を同時に使用するプログラム (任意のプログラミング言語) が発生する場合があります。 たとえば、次のコード例のカスタム マーシャラーは、 Marshal.ThrowExceptionForHR(int HResult) メソッドを使用して、特定の HRESULT 値を持つ例外をスローします。 メソッドは HRESULT を検索し、適切な例外の種類を生成します。 たとえば、次のコード フラグメントの HRESULT は ArgumentExceptionを生成します。

CMyClass::MethodThatThrows
{
    Marshal.ThrowExceptionForHR(COR_E_ARGUMENT);
}

次の表に、HRESULT から、.NETの同等の例外クラスへの一般的なマッピングを示します。 明示的なマッピングのない HRESULT 値は、 COMExceptionにマップされます。 完全な最新のマッピングは、dotnet/runtime リポジトリで確認できます。

拡張エラー情報を取得するには、マネージド クライアントが生成された例外オブジェクトのフィールドを調べる必要があります。 例外オブジェクトがエラーに関する有用な情報を提供するには、COM オブジェクトで IErrorInfo インターフェイスを実装する必要があります。 ランタイムは、 IErrorInfo によって提供される情報を使用して例外オブジェクトを初期化します。

COM オブジェクトが IErrorInfoをサポートしていない場合、ランタイムは既定値を使用して例外オブジェクトを初期化します。 次の表に、例外オブジェクトに関連付けられている各フィールドを示し、COM オブジェクトが IErrorInfoをサポートする場合の既定の情報のソースを示します。

スレッドにHRESULTが存在する場合、ランタイムはIErrorInfoを無視することがあります。 この動作は、 HRESULT と IErrorInfo が同じエラーを表していない場合に発生する可能性があります。

Message、Source、StackTraceなどの例外フィールドは、StackOverflowExceptionでは使用できません。

こちらも参照ください

• 高度な COM 相互運用性
• 例外