Marshal.ThrowExceptionForHR メソッド

ソース:

Marshal.cs

ソース:

Marshal.cs

ソース:

Marshal.cs

ソース:

Marshal.cs

ソース:

Marshal.cs

public:
 static void ThrowExceptionForHR(int errorCode);

[System.Security.SecurityCritical]
public static void ThrowExceptionForHR(int errorCode);

public static void ThrowExceptionForHR(int errorCode);

[<System.Security.SecurityCritical>]
static member ThrowExceptionForHR : int -> unit

static member ThrowExceptionForHR : int -> unit

Public Shared Sub ThrowExceptionForHR (errorCode As Integer)

パラメーター

属性

SecurityCriticalAttribute

注釈

このメソッドは、指定されたエラー HRESULT の例外オブジェクトを作成します。 HRESULT が 0 または正 (成功コード) の場合、メソッドは例外を作成またはスローせずに戻ります。

ThrowExceptionForHR(Int32) メソッドが設定されている場合、現在のスレッドの IErrorInfo インターフェイスに基づいて例外が返されることに注意してください。 この場合、 errorCode パラメーターは無視されます。

一部の障害 HRESULT は定義された例外にマップされますが、そうでない場合もあります。 HRESULT が定義された例外にマップされている場合、 ThrowExceptionForHR は例外のインスタンスを作成してスローします。 それ以外の場合は、 COMExceptionのインスタンスを作成し、HRESULT を使用してエラー コード フィールドを初期化し、その例外をスローします。 ThrowExceptionForHRが呼び出されると、アンマネージ GetErrorInfo 関数を使用して、エラーに関する追加情報の取得を試みます。

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

場合によっては、 ThrowExceptionForHR が前の COM 呼び出しから例外を返す場合があります。 この場合、次の回避策を使用し、2 番目のパラメーター (IntPtr(-1)) としてerrorInfoを渡すことができます。

public static void ThrowExceptionForHR(interrorCode,IntPtrerrorInfo)

こちらもご覧ください

• COMException

ソース:

Marshal.cs

ソース:

Marshal.cs

ソース:

Marshal.cs

ソース:

Marshal.cs

ソース:

Marshal.cs

public:
 static void ThrowExceptionForHR(int errorCode, IntPtr errorInfo);

[System.Security.SecurityCritical]
public static void ThrowExceptionForHR(int errorCode, IntPtr errorInfo);

public static void ThrowExceptionForHR(int errorCode, IntPtr errorInfo);

[<System.Security.SecurityCritical>]
static member ThrowExceptionForHR : int * nativeint -> unit

static member ThrowExceptionForHR : int * nativeint -> unit

Public Shared Sub ThrowExceptionForHR (errorCode As Integer, errorInfo As IntPtr)

パラメーター

属性

SecurityCriticalAttribute

注釈

このメソッドは、指定されたエラー HRESULT の例外オブジェクトを作成します。 HRESULT が 0 または正 (成功コード) の場合、メソッドは例外を作成またはスローせずに戻ります。

ThrowExceptionForHR メソッドは、errorInfo パラメーターを解放し、IErrorInfo インターフェイスの COM 参照数を減らします。

ThrowExceptionForHR メソッドが設定されている場合、現在のスレッドの IErrorInfo インターフェイスに基づいて例外が返されることに注意してください。 この場合、 errorCode パラメーターは無視されます。

一部の障害 HRESULT は定義された例外にマップされますが、そうでない場合もあります。 HRESULT が定義された例外にマップされている場合、 ThrowExceptionForHR は例外のインスタンスを作成してスローします。 それ以外の場合は、 System.Runtime.InteropServices.COMExceptionのインスタンスを作成し、HRESULT を使用してエラー コード フィールドを初期化し、その例外をスローします。 errorInfo パラメーターは、エラーに関する追加情報を取得するために使用されます。

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

こちらもご覧ください

• COMException

ソース:

Marshal.cs

ソース:

Marshal.cs

public:
 static void ThrowExceptionForHR(int errorCode, Guid % iid, IntPtr pUnk);

public static void ThrowExceptionForHR(int errorCode, in Guid iid, IntPtr pUnk);

static member ThrowExceptionForHR : int * Guid * nativeint -> unit

Public Shared Sub ThrowExceptionForHR (errorCode As Integer, ByRef iid As Guid, pUnk As IntPtr)

パラメーター