Marshal.GetHRForException メソッド
指定した例外を HRESULT に変換します。
Public Shared Function GetHRForException( _
ByVal e As Exception _) As Integer
[C#]
public static int GetHRForException(Exceptione);
[C++]
public: static int GetHRForException(Exception* e);
[JScript]
public static function GetHRForException(
e : Exception) : int;
パラメータ
- e
HRESULT に変換する Exception 。
戻り値
提供された例外に割り当てられる HRESULT。
解説
GetHRForException は、 GetErrorInfo COM API メソッドを呼び出して取得できる、例外の IErrorInfo インターフェイスも設定できます。 System.Runtime.InteropServices.PreserveSigAttribute を適用した COM インターフェイスのマネージ クラス実装でこのメソッドを使用すると、HRESULT 値を返します。属性付きメソッドですべての例外をキャッチし、 GetHRForException を使用して対応する HRESULT 値を返します。メソッドの外部に例外を送出すると、予期しない動作につながります。事実、共通言語ランタイムは、V テーブルを通じてこのようなメソッドを呼び出す COM クライアントに例外を渡すことができません。 IErrorInfo インターフェイスと GetErrorInfo COM メソッドの詳細については、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 セキュリティ:
- SecurityPermission (アンマネージ コードを操作するために必要なアクセス許可) SecurityPermissionFlag.UnmanagedCode (関連する列挙体)
参照
Marshal クラス | Marshal メンバ | System.Runtime.InteropServices 名前空間 | PreserveSigAttribute