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

Destination

目的地是應用程式送出訊息所在,或是應用程式從中收到訊息的來源(或兩者)。

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

相關概念
Connection Factory 和連線
連接 WebSphere 服務整合匯流排
目的地
目的地的萬用字元
主題統一資源識別碼 (URI)
佇列統一資源識別碼 (URI)
暫時目的地
相關工作
建立受管理物件

函數

函數摘要:
函數 說明
xmsDestCreate 使用指定的統一資源識別碼 (URI) 來建立目的地。
xmsDestCreateByType 使用指定的目的地類型和名稱來建立目的地。
xmsDestCreateTemporaryByType 建立暫時目的地。
xmsDestDispose 刪除目的地。
xmsDestGetName 取得目的地的名稱。
xmsDestGetTypeId 取得目的地的類型。
xmsDestToString 取得採用統一資源識別碼 (URI) 格式的目的地名稱。

xmsDestCreate – 建立目的地(使用 URI)

介面:
xmsRC xmsDestCreate(xmsCHAR *URI,
                    xmsHDest *destination,
                    xmsHErrorBlock errorBlock);

使用指定的統一資源識別碼 (URI) 來建立目的地。若未使用 URI 來指定目的地內容, 則會採用預設值。

如果目的地是一個佇列, 則這個函數不會在傳訊伺服器中建立佇列。您必須先建立佇列,應用程式才能呼叫這個函數。

參數:
URI(輸入)
採空值終止字串格式的 URI。
destination(輸出)
目的地的控點。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsDestCreateByType – 建立目的地(指定類型和名稱)

介面:
xmsRC xmsDestCreateByType(xmsDESTINATION_TYPE destinationType,
                          xmsCHAR *destinationName,
                          xmsHDest *destination,
                          xmsHErrorBlock errorBlock);

使用指定的目的地類型和名稱來建立目的地。

如果目的地是一個佇列, 則這個函數不會在傳訊伺服器中建立佇列。您必須先建立佇列,應用程式才能呼叫這個函數。

參數:
destinationType(輸入)
目的地的類型,其值必須是下列之一:
  • XMS_DESTINATION_TYPE_QUEUE
  • XMS_DESTINATION_TYPE_TOPIC
destinationName(輸入)
目的地的名稱,可以是佇列名稱或主題名稱。此名稱採用空值終止字串格式。
如果目的地為一個 WebSphere MQ 佇列,您可以採用下列方式之一來指定目的地的名稱:
  • QName
  • QMgrName/QName
其中,QNameWebSphere MQ 佇列的名稱, QMgrNameWebSphere MQ 佇列管理程式的名稱。WebSphere MQ 佇列名稱解析程序會使用 QNameQMgrName 的值來判斷實際的目的地佇列。如需佇列名稱解析程序的相關資訊, 請參閱WebSphere MQ 應用程式設計手冊
destination(輸出)
目的地的控點。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsDestCreateTemporaryByType – 建立暫時目的地

介面:
xmsRC xmsDestCreateTemporaryByType(xmsDESTINATION_TYPE destinationType,
                                   xmsHSess session,
                                   xmsHDest *destination,
                                   xmsHErrorBlock errorBlock);

建立暫時目的地。

暫時目的地的範圍為連線。只有連線所建立的階段作業才能使用暫時目的地。

除非明確刪除或連線結束(看何者較快發生), 暫時目的地會一直存在。

如需暫時目的地的相關資訊,請參閱暫時目的地

參數:
destinationType(輸入)
暫時目的地的類型,其值必須是下列之一:
  • XMS_DESTINATION_TYPE_QUEUE
  • XMS_DESTINATION_TYPE_TOPIC
session(輸入)
階段作業的控點。
destination(輸出)
暫時目的地的控點。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsDestDispose – 刪除目的地

介面:
xmsRC xmsDestDispose(xmsHDest *destination,
                     xmsHErrorBlock errorBlock);

刪除目的地。

如果目的地是一個佇列, 此函數不會刪除傳訊伺服器中的佇列,除非所建立的佇列是作為 XMS 暫時佇列。

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

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

xmsDestGetName – 取得目的地名稱

介面:
xmsRC xmsDestGetName(xmsHDest destination,
                     xmsCHAR *destinationName,
                     xmsINT length,
                     xmsINT *actualLength,
                     xmsHErrorBlock errorBlock);

取得目的地的名稱。

如需如何使用此函數的相關資訊, 請參閱會以值形式來傳回字串的 C 函數

參數:
destination(輸入)
目的地的控點。
destinationName(輸出)
內含目的地名稱的緩衝區。此名稱可以是佇列名稱或主題名稱。
length(輸入)
緩衝區的長度(以位元組計)。如果您指定的是 XMSC_QUERY_SIZE, 則不會傳回目的地名稱,而會將其長度放在 actualLength 參數中傳回。
actualLength(輸出)
目的地名稱的長度(以位元組計)。如果您在輸入中指定一個空值指標, 則不會傳回長度。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsDestGetTypeId – 取得目的地類型

介面:
xmsRC xmsDestGetTypeId(xmsHDest destination,
                       xmsDESTINATION_TYPE *destinationType,
                       xmsHErrorBlock errorBlock);

取得目的地的類型。

參數:
destination(輸入)
目的地的控點。
destinationType(輸出)
目的地的類型,其值為下列之一:
  • XMS_DESTINATION_TYPE_QUEUE
  • XMS_DESTINATION_TYPE_TOPIC
errorBlock(輸入)
錯誤區塊的控點或空值控點。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsDestToString – 以 URI 形式取得目的地名稱

介面:
xmsRC xmsDestToString(xmsHDest destination,
                      xmsCHAR *destinationName,
                      xmsINT length,
                      xmsINT *actualLength,
                      xmsHErrorBlock errorBlock);

取得採用統一資源識別碼 (URI) 格式的目的地名稱。

如需如何使用此函數的相關資訊, 請參閱會以值形式來傳回字串的 C 函數

參數:
destination(輸入)
目的地的控點。
destinationName(輸出)
內含 URI 的緩衝區。URI 可以是佇列 URI 或主題 URI。
length(輸入)
緩衝區的長度(以位元組計)。如果您指定的是 XMSC_QUERY_SIZE, 則不會傳回 URI,而會將其長度放在 actualLength 參數中傳回。
actualLength(輸出)
URI 的長度(以位元組計)。如果您在輸入中指定一個空值指標, 則不會傳回長度。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

Reference topic

使用條款 | 評比此網頁

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