Share via

Marshal.GetIDispatchForObject メソッド

  • [アーティクル]

マネージ オブジェクトから IDispatch インターフェイスを返します。

Public Shared Function GetIDispatchForObject( _
   ByVal o As Object _) As IntPtr
[C#]
public static IntPtr GetIDispatchForObject(objecto);
[C++]
public: static IntPtr GetIDispatchForObject(Object* o);
[JScript]
public static function GetIDispatchForObject(
   o : Object) : IntPtr;

パラメータ

  • o
    要求される IDispatch インターフェイスを持つオブジェクト。

戻り値

o パラメータの IDispatch ポインタ。

例外

例外の種類 条件
InvalidCastException o が要求されたインターフェイスをサポートしていません。

解説

マネージ コードで IDispatch インターフェイスを直接使用することはほとんどありません。ただし、 IntPtr 型として、またはカスタム マーシャリングで COM オブジェクトのパラメータを公開するメソッドを呼び出すときは、 GetIDispatchForObject を使用します。このメソッドでオブジェクトを呼び出すと、ポインタが返される前に、インターフェイス ポインタで参照カウントがインクリメントされます。ポインタの使用が終わったときは、必ず Marshal.Release を使用して参照カウントをデクリメントしてください。

マネージ オブジェクトでこのメソッドを使用すると、オブジェクトの COM 呼び出し可能ラッパーへのインターフェイス ポインタを取得できます。詳細については、「 COM 呼び出し可能ラッパー 」を参照してください。

メモ   このメソッドは 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 名前空間 | Release