英語で読む

次の方法で共有

Marshal.GetExceptionForHR メソッド

  • リファレンス

定義

名前空間:
System.Runtime.InteropServices
アセンブリ:
System.Runtime.InteropServices.dll
アセンブリ:
mscorlib.dll
アセンブリ:
netstandard.dll

HRESULT エラー コードを対応する Exception オブジェクトに変換します。

オーバーロード

GetExceptionForHR(Int32)

指定した HRESULT エラー コードを対応する Exception オブジェクトに変換します。
GetExceptionForHR(Int32, IntPtr)

例外オブジェクトの IErrorInfoインターフェイスに渡された追加エラー情報を使用して、指定した HRESULT エラー コードを対応する Exception オブジェクトに変換します。

GetExceptionForHR(Int32)

ソース:
Marshal.cs
ソース:
Marshal.cs
ソース:
Marshal.cs

指定した HRESULT エラー コードを対応する Exception オブジェクトに変換します。

C# 
[System.Security.SecurityCritical]
public static Exception GetExceptionForHR (int errorCode);
C# 
public static Exception? GetExceptionForHR (int errorCode);
C# 
public static Exception GetExceptionForHR (int errorCode);

パラメーター

errorCode
Int32

変換される HRESULT。

戻り値

Exception

変換後の HRESULT を表すオブジェクト。または HRESULT 値がエラー コード (S_OK や S_FALSE など) ではない場合は null。

属性
SecurityCriticalAttribute

注釈

メソッドをGetExceptionForHR呼び出ThrowExceptionForHRして例外をExceptionキャッチすることなく、HRESULT に基づいて を取得するには、 メソッドを使用します。

現在の IErrorInfo インターフェイスは、例外を構築するために使用されます。

各 HRESULT から .NET Framework の同等の例外クラスへのマッピングについては、「 方法: HRESULT と例外をマップする」を参照してください。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

GetExceptionForHR(Int32, IntPtr)

ソース:
Marshal.cs
ソース:
Marshal.cs
ソース:
Marshal.cs

例外オブジェクトの IErrorInfoインターフェイスに渡された追加エラー情報を使用して、指定した HRESULT エラー コードを対応する Exception オブジェクトに変換します。

C# 
[System.Security.SecurityCritical]
public static Exception GetExceptionForHR (int errorCode, IntPtr errorInfo);
C# 
public static Exception? GetExceptionForHR (int errorCode, IntPtr errorInfo);
C# 
public static Exception GetExceptionForHR (int errorCode, IntPtr errorInfo);

パラメーター

errorCode
Int32

変換される HRESULT。

errorInfo
IntPtr

エラーの詳細情報を提供する IErrorInfo インターフェイスへのポインター。 IntPtr(0) を指定すると、現在の IErrorInfo インターフェイスを使用できます。または IntPtr(-1) を指定すると、現在の IErrorInfo インターフェイスを無視し、エラー コードだけを使用して例外を構築できます。

戻り値

Exception

変換後の HRESULT を表すオブジェクトと errorInfo から取得された情報。または HRESULT 値がエラー コード (S_OK や S_FALSE など) ではない場合は null。

属性
SecurityCriticalAttribute

注釈

メソッドをGetExceptionForHR呼び出ThrowExceptionForHRして例外をキャッチせずに HRESULT に基づいて を取得Exceptionするには、 メソッドを使用します (そのため、対応するパフォーマンス オーバーヘッドを回避します)。 パラメーターは errorInfo 、エラーに関する追加情報 (テキスト記述、エラーを定義したインターフェイスのグローバル一意識別子 (GUID) など) を提供します。

変換で指定する必要があるカスタム エラー情報がある場合は、このメソッド オーバーロードを使用します。

各 HRESULT から .NET Framework の同等の例外クラスへのマッピングについては、「 方法: HRESULT と例外をマップする」を参照してください。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0