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

Exception

如果 XMS 在處理方法的呼叫時偵測到錯誤, XMS 會擲出異常狀況。異常狀況是一種物件,封裝錯誤的相關資訊。

繼承階層:
std::exception
   |
   +----xms::Exception

XMS 有一些不同類型的異常狀況, Exception 物件只是其中一種異常狀況類型。不過,Exception 類別則是其他 XMS 異常狀況類別的超類別。一旦找不到其他適用的異常狀況類型時, XMS 即會擲出 Exception 物件。

方法

方法摘要:
方法 說明
~Exception 刪除異常狀況和任何所鏈結的異常狀況。
dump 將異常狀況以格式化文字形式傾出至指定的 C++ 輸出串流中。
getErrorCode 取得錯誤碼。
getErrorData 取得提供錯誤之其他相關資訊的開放格式資料。
getErrorString 取得說明該錯誤的字元字串。
getHandle 取得 XMS 針對異常狀況所建之內部錯誤區塊的控點。
getJMSException 取得異常狀況代碼。
getLinkedException 取得異常狀況鏈中之下一個異常狀況的指標。
isNull 判斷 Exception 物件是否為一個空值物件。

~Exception – 刪除異常狀況

介面:
virtual ~Exception() throw();

刪除異常狀況和任何所鏈結的異常狀況。

參數:
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

dump – 傾出異常狀況

介面:
xmsVOID dump(std::ostream outputStream) const;

將異常狀況以格式化文字形式傾出至指定的 C++ 輸出串流中。

參數:
outputStream(輸入)
C++ 輸出串流。
傳回:
Void
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

getErrorCode – 取得錯誤碼

介面:
xmsINT getErrorCode() const;

取得錯誤碼。

參數:
傳回:
錯誤碼。
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

getErrorData – 取得錯誤資料

介面:
String getErrorData() const;

取得提供錯誤之其他相關資訊的開放格式資料。

參數:
傳回:
封裝錯誤資料的 String 物件。
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

getErrorString – 取得錯誤字串

介面:
String getErrorString() const;

取得說明該錯誤的字元字串。字串中的字元和代表錯誤碼之具名常數中的字元相同。

參數:
傳回:
封裝錯誤字串的 String 物件。
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

getHandle – 取得控點

介面:
xmsHErrorBlock getHandle() const;

取得 XMS 針對異常狀況所建之內部錯誤區塊的控點。

參數:
傳回:
錯誤區塊的控點。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

getJMSException – 取得異常狀況代碼

介面:
xmsJMSEXP_TYPE getJMSException() const;

取得異常狀況代碼。

參數:
傳回:
異常狀況代碼。
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

getLinkedException – 取得所鏈結的異常狀況

介面:
Exception * getLinkedException() const;

取得異常狀況鏈中之下一個異常狀況的指標。

參數:
傳回:
異常狀況的指標。如果鏈中已無其他異常狀況, 則方法會傳回一個空值指標。
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

isNull – 檢查是否為空值

介面:
xmsBOOL isNull() const;

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

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

Reference topic

使用條款 | 評比此網頁

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