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

處理 C 中的錯誤

C API 中的大部分函數都會傳回一個屬於回覆碼的值, 且會有一個屬於錯誤區塊控點的選用輸入參數。本節說明回覆碼和錯誤區塊的個別角色。

相關概念
可在執行時期處理的錯誤狀況

回覆碼

C 函數呼叫所傳回的回覆碼會指出呼叫是否成功。回覆碼的資料類型為 xmsRC。表 1 顯示可能的回覆碼和其意義。

表 1. C 函數呼叫所傳回的回覆碼
回覆碼 意義
XMS_OK 呼叫順利完成。
其他任何值 呼叫失敗。錯誤區塊含有呼叫失敗原因的詳細說明。回覆碼和傳回至錯誤區塊中的異常狀況代碼相同。

錯誤區塊

當應用程式呼叫 C 函數時,應用程式可在呼叫中以輸入參數形式包含錯誤區塊的控點。如果呼叫失敗,XMS 會將呼叫失敗原因的相關資訊儲存在錯誤區塊中。之後,應用程式可從錯誤區塊中擷取此資訊。

錯誤區塊所含的資訊如下:
異常狀況代碼
代表異常狀況的整數。異常狀況代碼提供呼叫失敗原因的高階指示, 但不會精確指出所發生的錯誤。標頭檔 xmsc.h 定義了每一個異常狀況代碼的具名常數。

異常狀況代碼和在相同狀況下 JMS 方法所擲出的 JMS 異常狀況相符。

錯誤碼
代表錯誤的整數。錯誤碼能更精確指出所發生的錯誤。標頭檔 xmsc.h 定義了每一個錯誤碼的具名常數。
錯誤字串
一個說明錯誤的空值終止字元字串。字串中的字元和代表錯誤碼之具名常數中的字元相同。
錯誤資料
一個提供錯誤的其他相關資訊的空值終止字元字串。此資訊為開放式。
鏈結的錯誤
所鏈結之錯誤區塊的控點。如果 XMS 需要報告失敗呼叫的詳細資訊, XMS 可另建一或多個錯誤區塊,並讓它們和應用程式所提供的錯誤區塊相鏈結。

XMS 提供一組 Helper 函數, 來建立錯誤區塊並從中擷取資訊。應用程式必須使用 Helper 函數來建立錯誤區塊並取得其控點, 才能呼叫第一個可接受輸入參數形式之控點的函數。如果函數呼叫失敗, 應用程式可使用其他 Helper 函數來擷取 XMS 儲存在錯誤區塊中之錯誤的相關資訊。如需這些 Helper 函數的相關資訊, 請參閱ErrorBlock


Concept topic

使用條款 | 評比此網頁

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