Marshal.GetExceptionForHR メソッド

定義

名前空間:

System.Runtime.InteropServices

アセンブリ:

System.Runtime.InteropServices.dll

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

オーバーロード

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

GetExceptionForHR(Int32)

ソース:

Marshal.cs

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

public:
 static Exception ^ GetExceptionForHR(int errorCode);

public static Exception? GetExceptionForHR (int errorCode);

static member GetExceptionForHR : int -> Exception

Public Shared Function GetExceptionForHR (errorCode As Integer) As Exception

パラメーター

errorCode

Int32

変換される HRESULT。

戻り値

Exception

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

注釈

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

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

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

こちらもご覧ください

• ThrowExceptionForHR
• IErrorInfo インターフェイス

GetExceptionForHR(Int32, IntPtr)

ソース:

Marshal.cs

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

public:
 static Exception ^ GetExceptionForHR(int errorCode, IntPtr errorInfo);

public static Exception? GetExceptionForHR (int errorCode, IntPtr errorInfo);

static member GetExceptionForHR : int * nativeint -> Exception

Public Shared Function GetExceptionForHR (errorCode As Integer, errorInfo As IntPtr) As Exception

パラメーター

errorCode

Int32

変換される HRESULT。

errorInfo

IntPtr

nativeint

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

戻り値

Exception

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

注釈

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

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

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

こちらもご覧ください

• ThrowExceptionForHR
• IErrorInfo インターフェイス