WebSphere Message Service Clients for C/C++ and .NET, Version 1.2 オペレーティング・システム: Linux, Windows

Requestor

アプリケーションは、リクエスターを使用して、要求メッセージを送信してから、応答を待機して応答を受信します。

関数

関数の要約:
関数 説明
xmsRequestorClose リクエスターを閉じます。
xmsRequestorCreate リクエスターを作成します。
xmsRequestorRequest 要求メッセージを送信してから、その要求メッセージを受信するアプリケーションからの応答を待機して応答を受信します。

xmsRequestorClose – リクエスターのクローズ

インターフェース:
xmsRC xmsRequestorClose(xmsHRequestor *requestor,
xmsHErrorBlock errorBlock);

リクエスターを閉じます。

アプリケーションが、既に閉じているリクエスターを閉じようとした場合、呼び出しは無視されます。

注: アプリケーションがリクエスターを閉じたとき、関連したセッションは閉じません。この点で、XMS の振る舞いは JMS とは異なります。
パラメーター:
requestor (入出力)
入力では、リクエスターのハンドル。出力で、関数は NULL ハンドルを戻します。
errorBlock (入力)
エラー・ブロックのハンドルまたは NULL ハンドル。
スレッド・コンテキスト:
任意
例外:
  • XMS_X_GENERAL_EXCEPTION

xmsRequestorCreate – リクエスターの作成

インターフェース:
xmsRC xmsRequestorCreate(xmsHSess session,
xmsHDest destination,
xmsHRequestor *requestor
xmsHErrorBlock errorBlock);

リクエスターを作成します。

パラメーター:
session (入力)
セッションのハンドル。セッションは処理済みであってはならず、以下の肯定応答モードのいずれかでなければなりません。
  • XMSC_AUTO_ACKNOWLEDGE
  • XMSC_DUPS_OK_ACKNOWLEDGE
destination (入力)
アプリケーションが要求メッセージを送信可能な宛先のハンドル。
requestor (出力)
リクエスターのハンドル。
errorBlock (入力)
エラー・ブロックのハンドルまたは NULL ハンドル。
スレッド・コンテキスト:
リクエスターに関連付けられたセッション
例外:
  • XMS_X_GENERAL_EXCEPTION

xmsRequestorRequest – 要求

インターフェース:
xmsRC xmsRequestorRequest(xmsHRequestor requestor,
xmsHMsg requestMessage,
xmsHMsg *replyMessage,
xmsHErrorBlock errorBlock);

要求メッセージを送信してから、その要求メッセージを受信するアプリケーションからの応答を待機して応答を受信します。

この関数への呼び出しは、応答が受信されるまで、またはセッションが終了するまでの、いずれか早い方の時点までブロックします。

パラメーター:
requestor (入力)
リクエスターのハンドル。
requestMessage (入力)
要求メッセージのハンドル。
replyMessage (出力)
応答メッセージのハンドル。
errorBlock (入力)
エラー・ブロックのハンドルまたは NULL ハンドル。
スレッド・コンテキスト:
リクエスターに関連付けられたセッション
例外:
  • XMS_X_GENERAL_EXCEPTION

Reference topic

ご利用条件 | フィードバック (英語のみ)

Timestamp icon最終更新: 8 Jun 2006
(C) Copyright IBM Corporation 2005, 2006. All Rights Reserved.
このインフォメーション・センターでは Eclipse テクノロジーが採用されています。(http://www.eclipse.org)