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

.NET Framework クラスライブラリリファレンス

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

Marshal.GetIUnknownForObject メソッド

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

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

Visual Basic (宣言)

Public Shared Function GetIUnknownForObject
 ( _
    o As Object _
) As IntPtr

Visual Basic (使用法)

Dim o As Object
Dim returnValue As IntPtr

returnValue = Marshal.GetIUnknownForObject(o)

public static IntPtr GetIUnknownForObject (
    Object o
)

C++

public:
static IntPtr GetIUnknownForObject (
    Object^ o
)

public static IntPtr GetIUnknownForObject (
    Object o
)

JScript

public static function GetIUnknownForObject
 (
    o : Object
) : IntPtr

パラメータ

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

戻り値
o パラメータの IUnknown ポインタ。

解説

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

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

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

メモ

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

使用例

GetIUnknownForObject メソッドを使用して、マネージオブジェクトの IUnknown インターフェイスを取得する方法を次のコード例に示します。

Visual Basic

Imports System.Runtime.InteropServices

Module Program


    Sub Run()

        ' Dim an Integer object
        Dim IntegerObject As Integer
 = 1

        ' Dim a pointer
        Dim pointer As IntPtr

        Console.WriteLine("Calling Marshal.GetIUnknownForObject...")

        ' Get the IUnKnown pointer for the Integer object
        pointer = Marshal.GetIUnknownForObject(IntegerObject)

        Console.WriteLine("Calling Marshal.Release...")

        ' Always call Marshal.Release to decrement the reference count.
        Marshal.Release(pointer)



    End Sub

    Sub Main(ByVal args() As
 String)

        Run()

    End Sub

End Module

using System;
using System.Runtime.InteropServices;

class Program
{

    static void Run()
    {

        // Create an int object
        int obj = 1;

        Console.WriteLine("Calling Marshal.GetIUnknownForObject...");

        // Get the IUnKnown pointer for the Integer object
        IntPtr pointer = Marshal.GetIUnknownForObject(obj);

        Console.WriteLine("Calling Marshal.Release...");

        // Always call Marshal.Release to decrement the reference count.
        Marshal.Release(pointer);
    }

    static void Main(string[]
 args)
    {
        Run();
    }
}