Marshal.CreateWrapperOfType メソッドとは何？わかりやすく解説 Weblio辞書

索引トップ用語の索引ランキング

Marshal.CreateWrapperOfType メソッド

名前空間: System.Runtime.InteropServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Public Shared Function CreateWrapperOfType
 ( _
    o As Object, _
    t As Type _
) As Object

Dim o As Object
Dim t As Type
Dim returnValue As Object

returnValue = Marshal.CreateWrapperOfType(o, t)

public static Object CreateWrapperOfType (
    Object o,
    Type t
)

public:
static Object^ CreateWrapperOfType (
    Object^ o, 
    Type^ t
)

public static Object CreateWrapperOfType (
    Object o, 
    Type t
)

public static function CreateWrapperOfType
 (
    o : Object, 
    t : Type
) : Object

戻り値
指定した型のインスタンスとなる新しくラップされたオブジェクト。

例外の種類	条件
ArgumentException	t は __ComObject から派生する必要があります。
ArgumentNullException	t パラメータが null 参照 (Visual Basic では Nothing) です。
InvalidCastException	必要なすべてのインターフェイスをサポートしていないため、o は指定された型に変換できません。

CreateWrapperOfType は COM クラス型 (通常は汎用の __ComObject 型) を別の COM クラス型に変換します。パラメータ o で表す入力側の COM オブジェクトは、ランタイム呼び出し可能ラッパーです。このラッパーの詳細については、「ランタイム呼び出し可能ラッパー」を参照してください。

Tlbimp.exe は COM のコクラスをマネージクラスとインターフェイスとしてインポートします。コクラスのインターフェイスには元のコクラスと同じ名前が付けられ、マネージクラスには元のコクラスの名前の末尾に "Class" が追加された名前が付けられます。たとえば、MyCoclass という名前のコクラスの場合、コクラスのインターフェイスの名前は MyCoclass となり、マネージクラスの名前は MyCoclassClass となります。t はインターフェイスではなくクラスである必要があるので、ここではコクラスのインターフェイスではなく、マネージクラス (MyCoclassClass) を指定してください。

メモ
新しいランタイム呼び出し可能ラッパーのインスタンスは、元のランタイム呼び出し可能ラッパーが公開していた IUnknown ポインタをラップするため、入力側の COM オブジェクトの ID は失われます。

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