WebSphere Message Service Clients for C/C++ and .NET, Version 1.2 オペレーティング・システム: Linux, Windows

Exception

XMS がメソッドの呼び出しを処理しているときにエラーを検出すると、XMS は例外をスローします。例外とは、エラーに関する情報をカプセル化するオブジェクトのことです。

継承の階層:
std::exception
|
+----xms::Exception

XMS 例外にはさまざまなタイプがあり、Exception オブジェクトは例外の 1 タイプに過ぎません。ただし、Exception クラスは、その他の XMS 例外クラスのスーパークラスです。 XMS は、Exception オブジェクト以外のタイプの例外では適切でない状態では、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;

例外のチェーン内の次の例外を指すポインターを取得します。

パラメーター:
なし
戻り値:
例外へのポインター。チェーン内に次の例外がない場合、メソッドは NULL ポインターを戻します。
スレッド・コンテキスト:
任意
例外:
  • XMS_X_GENERAL_EXCEPTION

isNull – ヌルであるかどうかを検査

インターフェース:
xmsBOOL isNull() const;

Exception オブジェクトがヌル・オブジェクトであるかどうかを判別します。

パラメーター:
なし
戻り値:
  • Exception オブジェクトがヌル・オブジェクトの場合は、xmsTRUE
  • Exception オブジェクトがヌル・オブジェクトでない場合は、xmsFALSE
スレッド・コンテキスト:
任意
例外:
  • XMS_X_GENERAL_EXCEPTION

Reference topic

ご利用条件 | フィードバック (英語のみ)

Timestamp icon最終更新: 8 Jun 2006
(C) Copyright IBM Corporation 2005, 2006. All Rights Reserved.
このインフォメーション・センターでは Eclipse テクノロジーが採用されています。(http://www.eclipse.org)