次の方法で共有


Marshal.GetExceptionForHR メソッド

定義

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。

戻り値

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

属性

注釈

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

現在の 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 インターフェイスを無視し、エラー コードだけを使用して例外を構築できます。

戻り値

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

属性

注釈

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

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

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

こちらもご覧ください

適用対象