次の方法で共有

Marshal.GetComInterfaceForObject メソッド

  • [アーティクル]

オブジェクトの指定したインターフェイスを表す IUnknown ポインタを返します。

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

パラメータ

  • o
    インターフェイスを提供するオブジェクト。
  • T
    要求されるインターフェイスの Type 。

戻り値

オブジェクトのインターフェイスを表す IUnknown ポインタ。

例外

例外の種類 条件
ArgumentException t がインターフェイスではありません。

または

型が COM から参照できません。
InvalidCastException o が要求されたインターフェイスをサポートしていません。

解説

このメソッドは、指定したオブジェクトに対して要求したインターフェイスを表す IUnknown ポインタを返します。このメソッドでオブジェクトを呼び出すと、ポインタが返される前に、インターフェイス ポインタで参照カウントがインクリメントされます。ポインタの使用が終わったときは、必ず Marshal.Release を使用して参照カウントをデクリメントしてください。生の COM インターフェイス ポインタを使用するときは、COM が定める規則に従ってください。

IntPtr 型として、またはカスタム マーシャリングで COM オブジェクトのパラメータを公開するメソッドを呼び出すときは、 GetComInterfaceForObject を使用できます。一般的ではありませんが、オブジェクトの COM 呼び出し可能ラッパーへのポインタを取得するためにマネージ オブジェクトでこのメソッドを使用することもできます。たとえば、COM にエクスポートされたマネージ オブジェクトで GetComInterfaceForObject を使用すると、 System.Runtime.InteropServices.UCOMIConnectionPointContainer のインターフェイス ポインタを取得できます。クラス ポインタでは、2 番目のパラメータ (t) に渡すための対応する型がないため、クラス インターフェイスへのポインタを取得することはできません。この場合は、代わりに、 Marshal.GetIDispatchForObject を使用して COM 呼び出し可能ラッパーの既定のインターフェイスのメンバを呼び出します。これは通常、オートディスパッチ クラス インターフェイスです。

ランタイム呼び出し可能ラッパーおよび 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 名前空間 | ComImportAttribute | Release | UCOMIConnectionPointContainer | GetIDispatchForObject