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

ConnectionFactory

應用程式會使用 Connection Factory 來建立連線。

有關 XMS 所定義的 ConnectionFactory 物件內容清單, 請參閱ConnectionFactory 內容

相關概念
Connection Factory 和連線
連接 WebSphere 服務整合匯流排
相關工作
建立受管理物件

函數

函數摘要:
函數 說明
xmsConnFactCreate 使用預設內容來建立 Connection Factory。
xmsConnFactCreateConnection 使用預設使用者身分來建立 Connection Factory。
xmsConnFactCreateConnectionForUser 使用指定的使用者身分來建立連線。
xmsConnFactDispose 刪除 Connection Factory。

xmsConnFactCreate – 建立 Connection Factory

介面:
xmsRC xmsConnFactCreate(xmsHConnFact *factory,
                        xmsHErrorBlock errorBlock);

使用預設內容來建立 Connection Factory。

參數:
factory(輸出)
Connection Factory 的控點。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsConnFactCreateConnection – 建立連線(使用預設使用者身分)

介面:
xmsRC xmsConnFactCreateConnection(xmsHConnFact factory,
                                  xmsHConn *connection,
                                  xmsHErrorBlock errorBlock);

使用預設使用者身分來建立 Connection Factory。

若有設定 Connection Factory 的 XMSC_USERID 和 XMSC_PASSWORD 內容,則會用來鑑別應用程式。如果沒有設定這些內容, 只要傳訊伺服器容許在不鑑別下進行連線, 則會建立連線而不鑑別應用程式。如果應用程式是在連結模式下連接 WebSphere MQ 佇列管理程式, 則會忽略這些內容。

連線是在停止模式下建立的。在應用程式呼叫 xmsConnStart() 之前都不會遞送訊息。

參數:
factory(輸入)
Connection Factory 的控點。
connection(輸出)
連線的控點。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_SECURITY_EXCEPTION

xmsConnFactCreateConnectionForUser – 建立連線(使用指定的使用者身分)

介面:
xmsRC xmsConnFactCreateConnectionForUser(xmsHConnFact factory,
                                         xmsCHAR *userID,
                                         xmsCHAR *password,
                                         xmsHConn *connection,
                                         xmsHErrorBock errorBlock);

使用指定的使用者身分來建立連線。

指定的使用者 ID 和密碼會用來鑑別應用程式。若有設定 Connection Factory 的 XMSC_USERID 和 XMSC_PASSWORD 內容,則會忽略它們。如果應用程式是在連結模式下連接 WebSphere MQ 佇列管理程式, 則會忽略使用者 ID 和密碼。

連線是在停止模式下建立的。在應用程式呼叫 xmsConnStart() 之前都不會遞送訊息。

參數:
factory(輸入)
Connection Factory 的控點。
userID(輸入)
用來鑑別應用程式的使用者 ID。使用者 ID 採用空值終止字串格式。如果使用者 ID 為空值, 則會改用 Connection Factory 的 XMSC_USERID 內容。
password(輸入)
用來鑑別應用程式的密碼。密碼採用空值終止字串格式。如果密碼為空值, 則會改用 Connection Factory 的 XMSC_PASSWORD 內容。
connection(輸出)
連線的控點。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_SECURITY_EXCEPTION

xmsConnFactDispose – 刪除 Connection Factory

介面:
xmsRC xmsConnFactDispose(xmsHConnFact *factory,
                         xmsHErrorBlock errorBlock);

刪除 Connection Factory。

如果應用程式試著刪除已刪除的 Connection Factory, 則會忽略該呼叫。

參數:
factory(輸入/輸出)
在輸入方面,為 Connection Factory 的控點。在輸出方面,函數會傳回空值控點。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

Reference topic

使用條款 | 評比此網頁

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