IpcClientChannel.CreateMessageSink メソッド

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

IpcClientChannel.CreateMessageSink メソッド

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

このメソッドは、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

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

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

C#

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

C++

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

J#

public 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 またはチャネル データ オブジェクトにメッセージを配信するチャネル メッセージ シンク。

例外

例外の種類	条件
RemotingException	指定されたシンクで IMessageSink が実装されていません。

解説

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

使用例

CreateMessageSink メソッドを使用するコード例を次に示します。

C#

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

C++

// Create a message sink.
String^ messageSinkUri;
Messaging::IMessageSink^ messageSink = clientChannel->CreateMessageSink(
   L"ipc://localhost:9090/RemoteObject.rem", nullptr,  messageSinkUri
 );
Console::WriteLine( L"The URI of the message sink is {0}.", messageSinkUri
 );
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

参照

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