RealProxy.GetCOMIUnknown メソッド

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

RealProxy.GetCOMIUnknown メソッド

現在のプロキシ インスタンスが表すオブジェクトへのアンマネージ参照を要求します。

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

Visual Basic (宣言)

Public Overridable Function
 GetCOMIUnknown ( _
    fIsMarshalled As Boolean _
) As IntPtr

Visual Basic (使用法)

Dim instance As RealProxy
Dim fIsMarshalled As Boolean
Dim returnValue As IntPtr

returnValue = instance.GetCOMIUnknown(fIsMarshalled)

C#

public virtual IntPtr GetCOMIUnknown (
    bool fIsMarshalled
)

C++

public:
virtual IntPtr GetCOMIUnknown (
    bool fIsMarshalled
)

J#

public IntPtr GetCOMIUnknown (
    boolean fIsMarshalled
)

JScript

public function GetCOMIUnknown (
    fIsMarshalled : boolean
) : IntPtr

パラメータ

fIsMarshalled

リモートの場所へのマーシャリングにオブジェクト参照が要求される場合は true。現在のプロセス内のアンマネージ オブジェクトとの COM を経由した通信にオブジェクト参照が要求される場合は false。

戻り値
現在のプロセス内のアンマネージ オブジェクトとの COM を経由した通信にオブジェクト参照が要求される場合は、COM 呼び出し可能ラッパー へのポインタ。リモートの場所へのマーシャリングにオブジェクト参照が要求される場合は、キャッシュされたまたは新しく生成された IUnknown COM インターフェイスへのポインタ。

解説

プロキシがマーシャリングに要求される場合は、現在のプロキシ インスタンスで表されるオブジェクトの IUnknown インターフェイスが返されます。IUnknown が以前に SetCOMIUnknown メソッドによってキャッシュされた場合は、そのインスタンスが返されます。それ以外の場合は、新しいインスタンスが返されます。

マーシャリングではなく、現在のプロセス内のアンマネージ オブジェクトとの通信にプロキシが要求される場合は、COM を通じて通信するために現在のプロセスで使用できる COM 呼び出し可能ラッパー (CCW) が返されます。

使用例

Visual Basic

<SecurityPermission(SecurityAction.LinkDemand, Flags := SecurityPermissionFlag.Infrastructure)>
 _
Public Overrides Function
 SupportsInterface(ByRef myGuid As Guid) As
 IntPtr
   Console.WriteLine("SupportsInterface method called")
   ' Object reference is requested for communication with unmanaged
 objects
   ' in the current process through COM.
   Dim myIntPtr As IntPtr = Me.GetCOMIUnknown(False)
   ' Stores an unmanaged proxy of the object.
   Me.SetCOMIUnknown(myIntPtr)
   ' return COM Runtime Wrapper pointer.
   Return myIntPtr
End Function 'SupportsInterface

C#

[SecurityPermission(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.Infrastructure)]
public override IntPtr SupportsInterface(ref Guid myGuid)
{
   Console.WriteLine("SupportsInterface method called");
   // Object reference is requested for communication with unmanaged
 objects
   // in the current process through COM.
   IntPtr myIntPtr = this.GetCOMIUnknown(false);
   // Stores an unmanaged proxy of the object.
   this.SetCOMIUnknown(myIntPtr);
   // return COM Runtime Wrapper pointer.
   return myIntPtr;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
RealProxy クラス
RealProxy メンバ
System.Runtime.Remoting.Proxies 名前空間