BinaryServerFormatterSink.ProcessMessage メソッド

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

BinaryServerFormatterSink.ProcessMessage メソッド

現在のシンクからのメッセージ処理を要求します。

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

Visual Basic (宣言)

Public Function ProcessMessage ( _
    sinkStack As IServerChannelSinkStack, _
    requestMsg As IMessage, _
    requestHeaders As ITransportHeaders, _
    requestStream As Stream, _
    <OutAttribute> ByRef responseMsg As
 IMessage, _
    <OutAttribute> ByRef responseHeaders As
 ITransportHeaders, _
    <OutAttribute> ByRef responseStream As
 Stream _
) As ServerProcessing

Visual Basic (使用法)

Dim instance As BinaryServerFormatterSink
Dim sinkStack As IServerChannelSinkStack
Dim requestMsg As IMessage
Dim requestHeaders As ITransportHeaders
Dim requestStream As Stream
Dim responseMsg As IMessage
Dim responseHeaders As ITransportHeaders
Dim responseStream As Stream
Dim returnValue As ServerProcessing

returnValue = instance.ProcessMessage(sinkStack, requestMsg, requestHeaders, requestStream,
 responseMsg, responseHeaders, responseStream)

C#

public ServerProcessing ProcessMessage (
    IServerChannelSinkStack sinkStack,
    IMessage requestMsg,
    ITransportHeaders requestHeaders,
    Stream requestStream,
    out IMessage responseMsg,
    out ITransportHeaders responseHeaders,
    out Stream responseStream
)

C++

public:
virtual ServerProcessing ProcessMessage (
    IServerChannelSinkStack^ sinkStack, 
    IMessage^ requestMsg, 
    ITransportHeaders^ requestHeaders, 
    Stream^ requestStream, 
    [OutAttribute] IMessage^% responseMsg, 
    [OutAttribute] ITransportHeaders^% responseHeaders, 
    [OutAttribute] Stream^% responseStream
) sealed

J#

public final ServerProcessing ProcessMessage (
    IServerChannelSinkStack sinkStack, 
    IMessage requestMsg, 
    ITransportHeaders requestHeaders, 
    Stream requestStream, 
    /** @attribute OutAttribute() */ /** @ref */ IMessage responseMsg, 
    /** @attribute OutAttribute() */ /** @ref */ ITransportHeaders responseHeaders,
 
    /** @attribute OutAttribute() */ /** @ref */ Stream responseStream
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

sinkStack

現在のシンクを呼び出したチャネル シンクのスタック。

requestMsg

要求を格納しているメッセージ。

requestHeaders

クライアントからの受信メッセージから取得したヘッダー。

requestStream

処理して、逆シリアル化シンクに渡す必要があるストリーム。

responseMsg

このメソッドから制御が戻るときに、応答メッセージを保持する IMessage が格納されます。このパラメータは初期化せずに渡されます。

responseHeaders

このメソッドから制御が戻るときに、クライアントへのリターン メッセージに追加されるヘッダーを保持する ITransportHeaders が格納されます。このパラメータは初期化せずに渡されます。

responseStream

このメソッドが返されるときに、トランスポート シンクに送信される Stream を格納します。このパラメータは初期化せずに渡されます。

戻り値
メッセージがどのように処理されたかに関する情報を提供する、ServerProcessing ステータス値。

解説

プロキシの役割は、そのプロキシに対するメソッド呼び出しをメッセージに変換することです。IMessage インターフェイスを実装するメッセージは、メッセージ シンク オブジェクト上で ProcessMessage を呼び出すことによって、クライアント エンドからサーバー エンドに渡されます。メッセージ シンクは、まとめてチェイン化されます。これは、各メッセージ シンクが現在のメッセージ シンクの作業完了後に、次のメッセージ シンクで ProcessMessage を呼び出す必要があることを示します。たとえば、同期に関連するメッセージ シンクは、ロックを取得または解放したり、その後にダウンストリームのメッセージ シンクにそれ以降の処理を代行させたりすることができます。

フォーマッタ チャネル シンクが、チャネルを経由して送信する必要があるメッセージを取得する場合は、SyncProcessMessage を呼び出し、パラメータとしてこのメッセージを渡します。その後、フォーマッタ シンクが、トランスポート ヘッダー配列を作成し、GetRequestStream をフォーマッタ シンクに呼び出します。この呼び出しは、シンク チェイン内で転送され、フォーマッタ シンクに戻される要求ストリームを任意のシンクによって作成できます。この呼び出しが返されると、メッセージはシリアル化され、ProcessMessage がシンク チェイン内の最初のチェインで呼び出されて、このメッセージがチャネル シンクに渡されます。

チャネル シンクは、メッセージを取得後、ストリームにデータを書き込み、ヘッダー配列にヘッダーを追加し、チャネル シンク自体をシンク スタックに追加してから、この呼び出しを次のシンクに転送します。呼び出しがチェインの末尾にあるトランスポート シンクに到達すると、トランスポート シンクがヘッダーとシリアル化されたメッセージをチャネルを通じてサーバーに送信します。サーバーでは処理が逆になります。

メッセージがサーバー側に到達すると、トランスポート シンクがヘッダーとシリアル化されたメッセージをストリームから取得し、フォーマッタ シンクに到達するまで、これらをシンク チェインを通じて転送します。フォーマッタ シンクは、その後、このメッセージを逆シリアル化して、リモート処理インフラストラクチャに転送します。次に、リモート処理インフラストラクチャは、このメッセージをメソッドの呼び出しに変換し、サーバー オブジェクトを呼び出します。

.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、1.1、1.0

参照

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