System.Runtime.Remoting.Channels.IServerChannelSinkProvider Interface

Assembly: Mscorlib.dll
Namespace: System.Runtime.Remoting.Channels
Summary
Creates server channel sinks for the server channel through which remoting messages flow.
C# Syntax:
public interface IServerChannelSinkProvider
Remarks
Channel sinks are connected to a server channel through implementations of the IServerChannelSinkProvider interface. All the remoting server channels provide constructors that take an IServerChannelSinkProvider as a parameter.

Channel sink providers are stored in a chain, and the user is responsible for chaining all channel sink providers together before passing the outer one to the channel constructor. IServerChannelSinkProvider provides a property called IServerChannelSinkProvider.Next for this purpose.

When multiple channel sink providers are specified in a configuration file, the remoting infrastructure will chain them together in the order they are found in the configuration file. The channel sink providers are created at the same time as the channel, during a RemotingConfiguration.Configure call.

After the IMethodCallMessage is generated, .NET Framework searches through the list of registered channels to find one that can process the call. Once an appropriate channel has been found, the channel sink is retrieved from the channel, and the IMethodCallMessage is forwarded to the sink for processing.

See also:
System.Runtime.Remoting.Channels Namespace

System.Runtime.Remoting.Channels.IServerChannelSinkProvider Member List:

Public Properties
Next Read-write

Gets or sets the next sink provider in the channel sink provider chain.
Public Methods
CreateSink Creates a sink chain.
GetChannelData Returns the channel data for the channel that the current sink is associated with.

System.Runtime.Remoting.Channels.IServerChannelSinkProvider Member Details

Property: Next (read-write)
Summary
Gets or sets the next sink provider in the channel sink provider chain.
C# Syntax:
IServerChannelSinkProvider Next {get; set;}

Return to top


Method: CreateSink(
   IChannelReceiver channel
)
Summary
Creates a sink chain.
C# Syntax:
IServerChannelSink CreateSink(
   IChannelReceiver channel
);
Parameters:

channel

The channel for which to create the channel sink chain.

Return Value:
The first sink of the newly formed channel sink chain, or null, indicating that this provider will not or cannot provide a connection for this endpoint.

Return to top


Method: GetChannelData(
   IChannelDataStore channelData
)
Summary
Returns the channel data for the channel that the current sink is associated with.
C# Syntax:
void GetChannelData(
   IChannelDataStore channelData
);
Parameters:

channelData

An IChannelDataStore object in which the channel data is to be returned.

Return to top


Top of page

Copyright (c) 2002 Microsoft Corporation. All rights reserved.