Marshal.GetExceptionForHR メソッド

定義

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

オーバーロード

名前 説明
GetExceptionForHR(Int32)

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

GetExceptionForHR(Int32, IntPtr)

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

GetExceptionForHR(Int32, Guid, IntPtr)

GetExceptionForHR(Int32)

ソース:
Marshal.cs
ソース:
Marshal.cs
ソース:
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 値がエラー コード (nullS_OKなど) を表していない場合にS_FALSE

属性

注釈

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

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

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

こちらもご覧ください

適用対象

GetExceptionForHR(Int32, IntPtr)

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

指定した 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);
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 値がエラー コード (nullS_OKなど) を表していない場合にS_FALSE

属性

注釈

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

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

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

こちらもご覧ください

適用対象

GetExceptionForHR(Int32, Guid, IntPtr)

ソース:
Marshal.cs
ソース:
Marshal.cs
public:
 static Exception ^ GetExceptionForHR(int errorCode, Guid % iid, IntPtr pUnk);
public static Exception? GetExceptionForHR(int errorCode, in Guid iid, IntPtr pUnk);
static member GetExceptionForHR : int * Guid * nativeint -> Exception
Public Shared Function GetExceptionForHR (errorCode As Integer, ByRef iid As Guid, pUnk As IntPtr) As Exception

パラメーター

errorCode
Int32
iid
Guid
pUnk
IntPtr

nativeint

返品

適用対象