名前

tpcancel()−未終了の応答に対する呼び出し記述子を無効にするためのルーチン

形式

#include <atmi.h> 
int tpcancel(int cd)

機能説明

tpcancel() は、tpacall() が返す呼び出し記述子 cd を取り消します。トランザクションに関連している呼び出し記述子を無効にしようとするとエラーになります。

正常終了の場合、cd は以後無効になり、cd のために受信する応答はすべて、何の警告もなく捨てられてしまいます。

マルチスレッドのアプリケーションの場合、TPINVALIDCONTEXT 状態のスレッドは tpcancel() の呼び出しを発行できません。

戻り値

異常終了すると、tpcancel() は -1 を返し、tperrno を設定してエラー条件を示します。

エラー

異常終了時には、tpcancel() は tperrno を次のいずれかの値に設定します。

関連項目