System.Runtime.Remoting.Channels.IClientChannelSinkStack Interface

Assembly: Mscorlib.dll
Namespace: System.Runtime.Remoting.Channels
Summary
Provides functionality for a stack of client channel sinks that must be invoked during an asynchronous message response decoding.
C# Syntax:
public interface IClientChannelSinkStack : IClientResponseChannelSinkStack
Remarks
The IClientChannelSinkStack is used during processing of responses to Asynchronous Calls.

During a synchronous call, the IClientChannelSink.ProcessMessage method is called when a message is outbound to the server. Each sink in the sink chain calls the IClientChannelSink.ProcessMessage method on the next sink until the call reaches the Transport Sink at the end of the chain. From there the message is transported to the server.

When the formatter sink is called through the IMessageSink.AsyncProcessMessage method, it dispatches the call asynchronously by calling IClientChannelSink.AsyncProcessRequest on the next channel sink. A stack of reply sinks is needed to process the response. Any sink that wants to process the response needs to push itself to the client channel sink stack inside of IClientChannelSink.AsyncProcessRequest.

See also:
System.Runtime.Remoting.Channels Namespace | IClientChannelSink

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

Public Methods
Pop Pops the information associated with all the sinks from the sink stack up to and including the specified sink.
Push Pushes the specified sink and information associated with it onto the sink stack.

Hierarchy:


System.Runtime.Remoting.Channels.IClientChannelSinkStack Member Details

Method: Pop(
   IClientChannelSink sink
)
Summary
Pops the information associated with all the sinks from the sink stack up to and including the specified sink.
C# Syntax:
object Pop(
   IClientChannelSink sink
);
Parameters:

sink

The sink to remove and return from the sink stack.

Return Value:
Information generated on the request side and associated with the specified sink.

Return to top


Method: Push(
   IClientChannelSink sink,
   object state
)
Summary
Pushes the specified sink and information associated with it onto the sink stack.
C# Syntax:
void Push(
   IClientChannelSink sink,
   object state
);
Parameters:

sink

The sink to push onto the sink stack.

state

Information generated on the request side that is needed on the response side.

Remarks


Note The information generated on the request side and specified in the state parameter is returned in the state parameter of the IClientChannelSink.AsyncProcessResponse method on the corresponding sink.

Return to top


Top of page

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