方法: HRESULT に例外を割り当てる

[アーティクル]
05/09/2023

COM メソッドでは、HRESULT を返してエラーを報告します。 .NET メソッドでは、例外をスローしてエラーを報告します。ランタイムは、この 2 つの間の遷移を処理します。 .NET Framework の例外クラスはそれぞれ HRESULT に割り当てられます。

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

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

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

新しい例外クラスを作成し、HRESULT に割り当てるには

次のコードを使用して、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 リポジトリを参照してください。

HRESULT	.NET の例外
`COR_E_APPLICATION`	`ApplicationException`
`COR_E_ARGUMENT` または `E_INVALIDARG`	`ArgumentException`
`COR_E_ARGUMENTOUTOFRANGE`	`ArgumentOutOfRangeException`
`COR_E_ARITHMETIC or ERROR_ARITHMETIC_OVERFLOW`	`ArithmeticException`
`COR_E_ARRAYTYPEMISMATCH`	`ArrayTypeMismatchException`
`COR_E_BADIMAGEFORMAT or ERROR_BAD_FORMAT`	`BadImageFormatException`
`COR_E_DIRECTORYNOTFOUND or ERROR_PATH_NOT_FOUND`	`DirectoryNotFoundException`
`COR_E_DIVIDEBYZERO`	`DivideByZeroException`
`COR_E_DUPLICATEWAITOBJECT`	`DuplicateWaitObjectException`
`COR_E_ENDOFSTREAM`	`EndOfStreamException`
`COR_E_ENTRYPOINTNOTFOUND`	`EntryPointNotFoundException`
`COR_E_EXCEPTION`	`Exception`
`COR_E_EXECUTIONENGINE`	`ExecutionEngineException`
`COR_E_FIELDACCESS`	`FieldAccessException`
`COR_E_FILENOTFOUND or ERROR_FILE_NOT_FOUND`	`FileNotFoundException`
`COR_E_FORMAT`	`FormatException`
`COR_E_INDEXOUTOFRANGE`	`IndexOutOfRangeException`
`COR_E_INVALIDCAST or E_NOINTERFACE`	`InvalidCastException`
`COR_E_INVALIDFILTERCRITERIA`	`InvalidFilterCriteriaException`
`COR_E_INVALIDOPERATION`	`InvalidOperationException`
`COR_E_IO`	`IOException`
`COR_E_MEMBERACCESS`	`AccessException`
`COR_E_METHODACCESS`	`MethodAccessException`
`COR_E_MISSINGFIELD`	`MissingFieldException`
`COR_E_MISSINGMANIFESTRESOURCE`	`MissingManifestResourceException`
`COR_E_MISSINGMEMBER`	`MissingMemberException`
`COR_E_MISSINGMETHOD`	`MissingMethodException`
`COR_E_NOTFINITENUMBER`	`NotFiniteNumberException`
`E_NOTIMPL`	`NotImplementedException`
`COR_E_NOTSUPPORTED`	`NotSupportedException`
`COR_E_NULLREFERENCE orE_POINTER`	`NullReferenceException`
`COR_E_OUTOFMEMORY or` `E_OUTOFMEMORY`	`OutOfMemoryException`
`COR_E_OVERFLOW`	`OverflowException`
`COR_E_PATHTOOLONG or ERROR_FILENAME_EXCED_RANGE`	`PathTooLongException`
`COR_E_RANK`	`RankException`
`COR_E_REFLECTIONTYPELOAD`	`ReflectionTypeLoadException`
`COR_E_SECURITY`	`SecurityException`
`COR_E_SERIALIZATION`	`SerializationException`
`COR_E_STACKOVERFLOW orERROR_STACK_OVERFLOW`	`StackOverflowException`
`COR_E_SYNCHRONIZATIONLOCK`	`SynchronizationLockException`
`COR_E_SYSTEM`	`SystemException`
`COR_E_TARGET`	`TargetException`
`COR_E_TARGETINVOCATION`	`TargetInvocationException`
`COR_E_TARGETPARAMCOUNT`	`TargetParameterCountException`
`COR_E_THREADINTERRUPTED`	`ThreadInterruptedException`
`COR_E_THREADSTATE`	`ThreadStateException`
`COR_E_TYPELOAD`	`TypeLoadException`
`COR_E_TYPEINITIALIZATION`	`TypeInitializationException`
`COR_E_VERIFICATION`	`VerificationException`

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

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

例外フィールド	COM からの情報のソース
`ErrorCode`	呼び出しから返された HRESULT。
`HelpLink`	`IErrorInfo->HelpContext` が 0 以外の場合、文字列は `IErrorInfo->GetHelpFile`、"#"、および `IErrorInfo->GetHelpContext` を連結して形成されます。それ以外の場合、文字列は `IErrorInfo->GetHelpFile` から返されます。
`InnerException`	常に null 参照 (Visual Basic では `Nothing`)。
`Message`	`IErrorInfo->GetDescription` から返される文字列。
`Source`	`IErrorInfo->GetSource` から返される文字列。
`StackTrace`	スタックトレース。
`TargetSite`	失敗を示す HRESULT を返したメソッドの名前。

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

次の方法で共有

方法: HRESULT に例外を割り当てる

新しい例外クラスを作成し、HRESULT に割り当てるには

関連項目

その他のリソース