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 オブジェクトに変換します。

public:
 static Exception ^ GetExceptionForHR(int errorCode);
[System.Security.SecurityCritical]
public static Exception GetExceptionForHR (int errorCode);
public static Exception? GetExceptionForHR (int errorCode);
public static Exception GetExceptionForHR (int errorCode);
[<System.Security.SecurityCritical>]
static member GetExceptionForHR : int -> Exception
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。

属性
SecurityCriticalAttribute

注釈

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

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

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

こちらもご覧ください

適用対象

GetExceptionForHR(Int32, IntPtr)

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

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

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);
public static Exception GetExceptionForHR (int errorCode, IntPtr errorInfo);
[<System.Security.SecurityCritical>]
static member GetExceptionForHR : int * nativeint -> Exception
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。

属性
SecurityCriticalAttribute

注釈

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

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

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

こちらもご覧ください

適用対象