tpstrerrordetail(3c)

名前

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() はヌルを返します。

エラー

異常終了すると、tpstrerrordetail() はヌルを返し、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));
       }
       .
       .
       .
}

関連項目