Marshal.GetExceptionForHR メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
HRESULT エラー コードを対応する Exception オブジェクトに変換します。
オーバーロード
| 名前 | 説明 |
|---|---|
| GetExceptionForHR(Int32) |
指定した HRESULT エラー コードを、対応する Exception オブジェクトに変換します。 |
| GetExceptionForHR(Int32, IntPtr) |
指定した HRESULT エラー コードを対応する Exception オブジェクトに変換し、例外オブジェクトの IErrorInfo インターフェイスに追加のエラー情報を渡します。 |
GetExceptionForHR(Int32)
指定した HRESULT エラー コードを、対応する Exception オブジェクトに変換します。
public:
static Exception ^ GetExceptionForHR(int errorCode);[System.Security.SecurityCritical]
public static Exception GetExceptionForHR(int errorCode);public static Exception GetExceptionForHR(int errorCode);[<System.Security.SecurityCritical>]
static member GetExceptionForHR : int -> Exceptionstatic member GetExceptionForHR : int -> ExceptionPublic Shared Function GetExceptionForHR (errorCode As Integer) As Exceptionパラメーター
- errorCode
- Int32
変換する HRESULT。
返品
変換された HRESULT を表すオブジェクト。HRESULT 値がエラー コード (S_OKやS_FALSEなど) を表していない場合にnull。
- 属性
注釈
ThrowExceptionForHR メソッドを呼び出して例外をキャッチすることなく、HRESULT に基づいてExceptionを取得するには、GetExceptionForHR メソッドを使用します。
現在の IErrorInfo インターフェイスは、例外を構築するために使用されます。
各 HRESULT から .NET Framework の同等の例外クラスへのマッピングについては、「方法: HRESULT と例外をマップするを参照してください。
こちらもご覧ください
適用対象
GetExceptionForHR(Int32, IntPtr)
指定した HRESULT エラー コードを対応する Exception オブジェクトに変換し、例外オブジェクトの IErrorInfo インターフェイスに追加のエラー情報を渡します。
public:
static Exception ^ GetExceptionForHR(int errorCode, IntPtr errorInfo);[System.Security.SecurityCritical]
public static Exception GetExceptionForHR(int errorCode, IntPtr errorInfo);public static Exception GetExceptionForHR(int errorCode, IntPtr errorInfo);[<System.Security.SecurityCritical>]
static member GetExceptionForHR : int * nativeint -> Exceptionstatic member GetExceptionForHR : int * nativeint -> ExceptionPublic Shared Function GetExceptionForHR (errorCode As Integer, errorInfo As IntPtr) As Exceptionパラメーター
- errorCode
- Int32
変換する HRESULT。
- errorInfo
-
IntPtr
nativeint
エラーに関する詳細情報を提供する IErrorInfo インターフェイスへのポインター。 現在のIErrorInfo インターフェイスを使用するIntPtr(0)を指定するか、IntPtr(-1)現在のIErrorInfo インターフェイスを無視し、エラー コードから例外を作成することができます。
返品
変換された HRESULT と、errorInfoから取得した情報を表すオブジェクト。HRESULT 値がエラー コード (S_OKやS_FALSEなど) を表していない場合にnull。
- 属性
注釈
ThrowExceptionForHR メソッドを呼び出して例外をキャッチすることなく、HRESULT に基づいてExceptionを取得するには、GetExceptionForHR メソッドを使用します (そのため、対応するパフォーマンス オーバーヘッドを回避します)。
errorInfo パラメーターは、エラーに関する追加情報 (テキストの説明や、エラーを定義したインターフェイスのグローバル一意識別子 (GUID) など) を提供します。
変換で指定する必要があるカスタム エラー情報がある場合は、このメソッドオーバーロードを使用します。
各 HRESULT から .NET Framework の同等の例外クラスへのマッピングについては、「方法: HRESULT と例外をマップするを参照してください。