WebSphere Message Service Clients for C/C++ and .NET, Version 1.2 作業系統: Linux, Windows

Requestor

應用程式會使用要求者來傳送要求訊息, 並等待和接收回覆。

繼承階層:
xms::PropertyContext
   |
   +----xms::Requestor

建構子

建構子摘要:
建構子 說明
Requestor 建立要求者。

Requestor – 建立要求者

介面:
Requestor(const Session & session,
          const Destination & destination);

建立要求者。

參數:
session(輸入)
Session 物件。階段作業不得為交易式,且其確認模式必須是下列之一:
  • XMSC_AUTO_ACKNOWLEDGE
  • XMSC_DUPS_OK_ACKNOWLEDGE
destination(輸入)
代表應用程式可將要求訊息送往之目的地的 Destination 物件。
執行緒環境定義:
要求者的相關聯階段作業
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

方法

方法摘要:
方法 說明
close 關閉要求者。
getHandle 取得 C 應用程式在存取要求者時所要使用的控點。
isNull 判斷 Requestor 物件是否為一個空值物件。
request 傳送要求訊息,並等待和接收收到要求訊息之應用程式的回覆。

close – 關閉要求者

介面:
xmsVOID close();

關閉要求者。

如果應用程式試著關閉已關閉的要求者, 則會忽略該呼叫。

註: 當應用程式關閉要求者時, 相關聯的階段作業並不會跟著關閉。就此方面來說,XMS 的行為即和 JMS 有所不同。
參數:
傳回:
Void
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

getHandle – 取得控點

介面:
xmsHRequestor getHandle() const;

取得 C 應用程式在存取要求者時所要使用的控點。

參數:
傳回:
要求者的控點。
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

isNull – 檢查是否為空值

介面:
xmsBOOL isNull() const;

判斷 Requestor 物件是否為一個空值物件。

參數:
傳回:
  • 如果 Requestor 物件為空值物件,則為 xmsTRUE
  • 如果 Requestor 物件不是空值物件,則為 xmsFALSE
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

request – 要求

介面:
Message * request(const Message & requestMessage) const;

傳送要求訊息,並等待和接收收到要求訊息之應用程式的回覆。

此方法的呼叫會暫停執行, 直到收到回覆或直到階段作業結束為止(看何者較快發生)。

參數:
requestMessage(輸入)
封裝要求訊息的 Message 物件。
傳回:
封裝回覆訊息之 Message 物件的指標。
執行緒環境定義:
要求者的相關聯階段作業
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

繼承的方法


Reference topic

使用條款 | 評比此網頁

時間戳記前次更新: 25 Apr 2006
(C) Copyright IBM Corporation 2005. All Rights Reserved.
本資訊中心採用 Eclipse 技術。(http://www.eclipse.org)