Marshal.GetTypedObjectForIUnknown メソッド
COM オブジェクトを表す、指定した型のマネージ オブジェクトを返します。
Public Shared Function GetTypedObjectForIUnknown( _
ByVal pUnk As IntPtr, _ ByVal t As Type _) As Object
[C#]
public static object GetTypedObjectForIUnknown(IntPtrpUnk,Typet);
[C++]
public: static Object* GetTypedObjectForIUnknown(IntPtrpUnk,Type* t);
[JScript]
public static function GetTypedObjectForIUnknown(
pUnk : IntPtr,t : Type) : Object;
パラメータ
- pUnk
アンマネージ オブジェクトの IUnknown インターフェイスへのポインタ。 - t
要求されたマネージ クラスの Type 。
戻り値
要求されたアンマネージ COM オブジェクトを表す、 Type オブジェクトに対応するクラスのインスタンス。
例外
例外の種類 | 条件 |
---|---|
ArgumentException | t が System.Runtime.InteropServices.ComImportAttribute に属性付けされていません。 |
解説
t パラメータは、COM インポート型または COM インポート型のサブタイプである必要があります。さらに、 t は、タイプ ライブラリ インポータ ( Tlbimp.exe) によってメタデータがインポートされた型である必要があります。この型は、クラスである必要があります。COM のクラスの名前を保持している、関連付けられているコクラス インターフェイスであってはいけません。たとえば、Tlbimp.exe は、Myclass を MyclassClass クラスと Myclass コクラス インターフェイスとしてインポートしたとします。このメソッドでは必ず、MyClass ではなく、MyclassClass を使用してください。インポートされたクラスおよびコクラスのインターフェイスの詳細については、「 インポート時の型の変換 」を参照してください。
pUnk パラメータのオブジェクトが既に取得されている場合、 t は無視され、既存のオブジェクトが返されます。 pUnk は IUnknown インターフェイス ポインタを表します。ただし、すべての COM インターフェイスは直接的または間接的に IUnknown から派生しているので、このメソッドには任意の COM インターフェイスを渡すことができます。 GetTypedObjectForIUnknown が返すオブジェクトはランタイム呼び出し可能ラッパーです。共通言語ランタイムはこれを他のマネージ オブジェクトと同様に管理します。詳細については、「 ランタイム呼び出し可能ラッパー 」を参照してください。
メモ このメソッドは 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 名前空間 | ComImportAttribute | タイプ ライブラリ インポータ (Tlbimp.exe)