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(輸入/輸出)
在輸入方面,為要求者的控點。在輸出方面,函數會傳回空值控點。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
任何
異常狀況:
  • 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(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
要求者的相關聯階段作業
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsRequestorRequest – 要求

介面:
xmsRC xmsRequestorRequest(xmsHRequestor requestor,
                          xmsHMsg requestMessage,
                          xmsHMsg *replyMessage,
                          xmsHErrorBlock errorBlock);

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

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

參數:
requestor(輸入)
要求者的控點。
requestMessage(輸入)
要求訊息的控點。
replyMessage(輸出)
回覆訊息的控點。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
要求者的相關聯階段作業
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

Reference topic

使用條款 | 評比此網頁

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