IpcChannel.CreateMessageSink メソッド

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

IpcChannel.CreateMessageSink メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定した URL またはチャネル データ オブジェクトにメッセージを配信するチャネル メッセージ シンクを返します。

名前空間: System.Runtime.Remoting.Channels.Ipc
アセンブリ: System.Runtime.Remoting (system.runtime.remoting.dll 内)
構文

Visual Basic (宣言)

Public Function CreateMessageSink ( _
    url As String, _
    remoteChannelData As Object, _
    <OutAttribute> ByRef objectURI As
 String _
) As IMessageSink

Visual Basic (使用法)

Dim instance As IpcChannel
Dim url As String
Dim remoteChannelData As Object
Dim objectURI As String
Dim returnValue As IMessageSink

returnValue = instance.CreateMessageSink(url, remoteChannelData, objectURI)

C#

public IMessageSink CreateMessageSink (
    string url,
    Object remoteChannelData,
    out string objectURI
)

C++

public:
virtual IMessageSink^ CreateMessageSink (
    String^ url, 
    Object^ remoteChannelData, 
    [OutAttribute] String^% objectURI
) sealed

J#

public final IMessageSink CreateMessageSink (
    String url, 
    Object remoteChannelData, 
    /** @attribute OutAttribute() */ /** @ref */ String objectURI
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

url

新しいシンクがメッセージを配信する先の URL。null 参照 (Visual Basic では Nothing) でもかまいません。

remoteChannelData

新しいシンクがメッセージを配信する先のリモート ホストのチャネル データ オブジェクト。null 参照 (Visual Basic では Nothing) でもかまいません。

objectURI

このメソッドが返されるときに、指定した URL またはチャネル データ オブジェクトにメッセージを配信する新しいチャネル メッセージ シンクの URI を格納します。このパラメータは初期化せずに渡されます。

戻り値
指定した URL またはチャネル データ オブジェクトにメッセージを配信するチャネル メッセージ シンク。

解説

CreateMessageSink メソッドは、指定した URL またはチャネル データ オブジェクトにメッセージを配信するチャネル メッセージ シンクを返します。uri パラメータが null 参照 (Visual Basic では Nothing) の場合は、シンクの対象として remoteChannelData が使用されます。url または remoteChannelData のいずれかのパラメータを null 参照 (Visual Basic では Nothing) にすることはできますが、両方はできません。

チャネル シンクは、そのチャネルを流れている基になるメッセージにアクセスできるようにするプラグイン ポイント、およびリモート オブジェクトにメッセージを送信するために転送機構が使用するストリームを提供します。チャネル シンクは互いにリンクされて ChannelSinkProviders のチェインとなり、すべてのチャネル メッセージはこのシンク チェインを流れた後で、最終的にシリアル化されて転送されます。

使用例

CreateMessageSink メソッドを使用するコード例を次に示します。このコード例は、IpcChannel クラスのトピックで取り上げているコード例の一部分です。

C#

// Create a message sink.
string objectUri;
System.Runtime.Remoting.Messaging.IMessageSink messageSink =
    channel.CreateMessageSink(
        "ipc://localhost:9090/RemoteObject.rem", null,
        out objectUri);
Console.WriteLine("The URI of the message sink is {0}.",
    objectUri);
if (messageSink != null)
{
    Console.WriteLine("The type of the message sink is {0}.",
        messageSink.GetType().ToString());
}

C++

// Create a message sink.
String^ objectUri;
System::Runtime::Remoting::Messaging::IMessageSink^ messageSink = channel->CreateMessageSink(
   L"ipc://localhost:9090/RemoteObject.rem", nullptr, objectUri
 );
Console::WriteLine( L"The URI of the message sink is {0}.", objectUri );
if ( messageSink != nullptr )
{
   Console::WriteLine( L"The type of the message sink is {0}.", messageSink->GetType()
 );
}

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

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

参照

関連項目
IpcChannel クラス
IpcChannel メンバ
System.Runtime.Remoting.Channels.Ipc 名前空間