名前

tpstrerrordetail()−BEA Tuxedo ATMI のエラーに関する詳細なメッセージ文字列の取得

形式

#include <atmi.h> 
char * tpstrerrordetail(int err, long flags)

機能説明

tpstrerrordetail() は、Tuxedo ATMI エラーの詳細情報のテキストを取り出すのに使用します。err は、tperrordetail() が返す値です。

ユーザは、tpstrerrordetail() が返したポインタを userlog() または fprintf() に対する引数として使用できます。

flags は将来の使用を考慮して予約されているため、ゼロを指定してください。

マルチスレッドのアプリケーション中のスレッドは、TPINVALIDCONTEXT を含め、どのコンテキスト状態で実行していても、tpstrerrordetail() の呼び出しを発行できます。

戻り値

正常終了した場合は、この関数は、エラー・メッセージのテキストを持つ文字列を指すポインタを返します。

異常終了時 (すなわち err が無効なエラー・コードの場合)、tpstrerrordetail() は NULL を返します。

エラー

異常終了すると、tpstrerrordetail() は NULL を返し、tperrno は設定しません。

使用例

#include <atmi.h> .  .  .  
int ret;
char *p;

if (tpbegin(10,0) == -1) {
       ret = tperrordetail(0);
       if (ret == -1) {
              (void) fprintf(stderr, “tperrordetail() failed!¥n”);
              (void) fprintf(stderr, “tperrno = %d, %s¥n”,
                     tperrno, tpstrerror(tperrno));
       }

       else if (ret != 0) {
              (void) fprintf(stderr, ﾒerrordetail:%s\nﾓ,
                             tpstrerrordetail(ret, 0));
       }
       .
       .
       .
}

関連項目