次の方法で共有


IpcChannel.CreateMessageSink(String, Object, String) メソッド

定義

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

public:
 virtual System::Runtime::Remoting::Messaging::IMessageSink ^ CreateMessageSink(System::String ^ url, System::Object ^ remoteChannelData, [Runtime::InteropServices::Out] System::String ^ % objectURI);
public System.Runtime.Remoting.Messaging.IMessageSink CreateMessageSink (string url, object remoteChannelData, out string objectURI);
abstract member CreateMessageSink : string * obj * string -> System.Runtime.Remoting.Messaging.IMessageSink
override this.CreateMessageSink : string * obj * string -> System.Runtime.Remoting.Messaging.IMessageSink
Public Function CreateMessageSink (url As String, remoteChannelData As Object, ByRef objectURI As String) As IMessageSink

パラメーター

url
String

新しいシンクがメッセージを配信する先の URL。 null の可能性があります。

remoteChannelData
Object

新しいシンクがメッセージを配信する先のリモート ホストのチャネル データ オブジェクト。 null の可能性があります。

objectURI
String

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

戻り値

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

実装

CreateMessageSink メソッドを使用するコード例を次に示します。 このコード例は、IpcChannel クラスのために提供されている大規模な例の一部です。

// 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() );
}
// 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());
}

注釈

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

チャネル シンクは、チャネルを通過する基になるメッセージと、リモート オブジェクトにメッセージを送信するためにトランスポート メカニズムで使用されるストリームへのアクセスを許可するプラグイン ポイントを提供します。 チャネル シンクは の ChannelSinkProviders チェーンでリンクされ、メッセージが最終的にシリアル化されて転送される前に、すべてのチャネル メッセージがこのシンク チェーンを通過します。

適用対象