IpcClientChannel.CreateMessageSink(String, Object, String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve un receptor de mensajes de canal que envía mensajes a la dirección URL o al objeto de datos del canal especificados.
public:
virtual System::Runtime::Remoting::Messaging::IMessageSink ^ CreateMessageSink(System::String ^ url, System::Object ^ remoteChannelData, [Runtime::InteropServices::Out] System::String ^ % objectURI);
public virtual 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 Overridable Function CreateMessageSink (url As String, remoteChannelData As Object, ByRef objectURI As String) As IMessageSink
Parámetros
- url
- String
Dirección URL a la que el nuevo receptor envía mensajes. Este parámetro puede ser null
.
- remoteChannelData
- Object
Objeto de datos del canal del host remoto al que el nuevo receptor debe enviar mensajes. Este parámetro puede ser null
.
- objectURI
- String
Cuando este método finaliza, contiene la dirección URI del nuevo receptor de mensajes del canal que envía mensajes a la dirección URL o al objeto de datos del canal especificados. Este parámetro se pasa sin inicializar.
Devoluciones
Receptor de mensajes del canal que envía mensajes a la dirección URL o al objeto de datos de canal especificados.
Implementaciones
Excepciones
El receptor proporcionado no implementa IMessageSink.
Ejemplos
En el ejemplo de código siguiente, se muestra cómo se utiliza el método CreateMessageSink.
// 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() );
}
// 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());
}
Comentarios
El CreateMessageSink método devuelve un receptor de mensajes de canal que entrega mensajes a la dirección URL especificada o al objeto de datos del canal. Si el uri
parámetro es null
, remoteChannelData
se usa como destino para el receptor. url
Los parámetros o remoteChannelData
pueden ser null
, pero no ambos.