Marshal.ThrowExceptionForHR メソッド

ソース:

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 番目のパラメーター (errorInfo) として を渡IntPtr(-1)すことができます。

public static void ThrowExceptionForHR(interrorCode,IntPtrerrorInfo)

こちらもご覧ください

• COMException

ソース:

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