InitializeMessageメソッド

機能

例外が発生したときにメッセージテキストを取得できるように初期化します。

形式

void InitializeMessage(void) throw DBSQLCA

引数

なし

戻り値

なし

機能詳細

DABroker for C++クラスライブラリ(以下クラスライブラリと呼びます)のメッセージテキストを初期化します。メッセージテキストとは,次のものを指します。

DB_ERROR_NOT_ENOUGH_MEMORY <-エラーコード
メモリ容量が不足しています。 <-メッセージテキスト

メッセージテキストは,DABroker for C++が提供するメッセージテキストファイル(dabcppmj.txt又はdabcppme.txt)に格納されています。

取得するメッセージテキストが日本語(SJISモードの場合)になるか,英語(EUCモードまたはASCIIモードの場合)になるかは,DABrokerのDAB_LANG(LANG環境変数)に依存します。

クラスライブラリのメッセージテキストを取得したい場合は,このメソッドを呼び出してメッセージテキストを初期化しておきます。通常,トップオブジェクトを生成した後,すぐにこのメソッドを呼び出して初期化してください。

メッセージテキストは,ErrorMessageプロパティで取得します。

なお,クラスライブラリのエラーコードだけの取得でもよい場合は,このメソッドを呼び出す必要はありません。また,このメソッドを呼び出さなくても,データベースのエラーメッセージは取得できます。

発生する例外

DBSQLCA(RetCode)

DB_ERROR_NOT_ENOUGH_MEMORY
メモリ容量が不足しています。
DB_ERROR_FILE_NOT_FOUND
メッセージテキストファイルが見つかりません。
DB_ERROR_INITIALIZE_ERROR
メモリ不足もしくは環境設定の不正によって,処理を続行できません。