次の方法で共有

Marshal.ThrowExceptionForHR メソッド (Int32)

  • [アーティクル]

特定の失敗 HRESULT 値を使用して例外をスローします。

Overloads Public Shared Sub ThrowExceptionForHR( _
   ByVal errorCode As Integer _)
[C#]
public static void ThrowExceptionForHR(interrorCode);
[C++]
public: static void ThrowExceptionForHR(interrorCode);
[JScript]
public static function ThrowExceptionForHR(
   errorCode : int);

パラメータ

  • errorCode
    必要な例外に対応する HRESULT。

解説

このメソッドは、指定したエラー HRESULT の例外オブジェクトを作成します。HRESULT が 0 または正の値 (成功コード) の場合、このメソッドは、例外を作成もスローもしないまま、終了します。

エラー HRESULT には、正しく定義された例外に割り当てられているものもあれば、定義された例外に割り当てられていないものもあります。HRESULT が定義された例外に割り当てられている場合は、 ThrowExceptionForHR が例外のインスタンスを作成し、それをスローします。それ以外の場合は、 System.Runtime.InteropServices.COMException のインスタンスを作成し、HRESULT を使用してエラー コード フィールドを初期化し、その例外をスローします。このメソッドは、呼び出されると、アンマネージ GetErrorInfo 関数を使用してエラーに関する補足情報を取得しようとします。

各 HRESULT から .NET Framework の対応する例外クラスへの割り当てについては、「 HRESULT と例外 」を参照してください。 GetErrorInfo の詳細については、MSDN ライブラリを参照してください。

メモ   このメソッドは SecurityAction.LinkDemand を使用して、信頼関係のないコードからの呼び出しを防ぎます。 SecurityPermissionAttribute.UnmanagedCode アクセス許可は、直前の呼び出し元にのみ要求されます。信頼性が一部しか確認されていないコードから呼び出すことができるコードの場合、ユーザー入力を検証せずに Marshal クラスに渡すことは避けてください。 LinkDemand メンバの使用に関する重要な制約事項については、「 Demand と LinkDemand 」を参照してください。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

参照

Marshal クラス | Marshal メンバ | System.Runtime.InteropServices 名前空間 | Marshal.ThrowExceptionForHR オーバーロードの一覧 | COMException