RealProxy.SetCOMIUnknown メソッド

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

RealProxy.SetCOMIUnknown メソッド

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

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

Visual Basic (宣言)

Public Overridable Sub SetCOMIUnknown
 ( _
    i As IntPtr _
)

Visual Basic (使用法)

Dim instance As RealProxy
Dim i As IntPtr

instance.SetCOMIUnknown(i)

C#

public virtual void SetCOMIUnknown (
    IntPtr i
)

C++

public:
virtual void SetCOMIUnknown (
    IntPtr i
)

J#

public void SetCOMIUnknown (
    IntPtr i
)

JScript

public function SetCOMIUnknown (
    i : IntPtr
)

パラメータ

i

現在のプロキシ インスタンスが表すオブジェクトの IUnknown インターフェイスへのポインタ。

解説

アンマネージ プロキシが COM を通じて共通言語ランタイムと通信しようとすると、ランタイムはアンマネージ プロキシで表されるリモート オブジェクトを解決します。リモート オブジェクトがマネージ オブジェクトであり、共通言語環境に格納されている場合は、配布された COM を通じてこのオブジェクトと通信するのではなく、オブジェクトが現在のプロセスに送信されます。

リモート オブジェクトが MarshalByRefObject から派生していない場合、リモート オブジェクトはシリアル化されて現在の場所にコピーされます。リモート オブジェクトが MarshalByRefObject から派生している場合、リモート オブジェクトは透過プロキシを返し、リモート処理インフラストラクチャが、今後使用するためにアンマネージ プロキシ (IUnknown インターフェイス) を透過プロキシにキャッシュします。

使用例

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 名前空間