tpcancel

名称

リクエスト/レスポンス型サービスのキャンセル

形式

ANSI C,C++の形式

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

K&R版 Cの形式

#include <xatmi.h>
int  tpcancel(cd)
int     cd;

機能

関数tpcancel()は,関数tpacall()のリターン値である記述子cdをキャンセルします。グローバルトランザクションに属している記述子をキャンセルしようとすると,エラーになります。

成功した場合,cdは無効となって,cdとして受信した応答は,暗黙的に捨てられます(コミュニケーションリソースマネジャによって)。

『引数』

『●cd

記述子を設定します。』

リターン値

エラー時には,-1をリターンして,tperrnoにエラーの状態を示す値を設定します。

エラー

次のような場合,tpcancel()はエラーリターンして,次のうちどれか一つの値をtperrnoに設定します。

リターン値リターン値(数値)意味
TPEBADDESC2引数cdは,間違った記述子です。
TPEOS7オペレーティングシステムにエラーが起こりました。厳密なエラーの性質は,product-specificな方法で定義されます。
TPEPROTO9tpcancel()が間違った状況で呼ばれました。
TPESYSTEM12コミュニケーションリソースマネジャシステムでエラーが起こりました。厳密なエラーの性質は,product-specificな方法で定義されます。
TPETRAN14引数cdが,呼び出し側のグローバルトランザクションに参加しています。エラーのあとでも,引き続き記述子cdは有効で,呼び出し側の現在のトランザクションには影響しません。

関連項目

tpacall().

『OpenTP1で使う場合の注意事項』

  1. 『OSI TP通信をするXATMIのエラーは,従来のTCP/IPとエラー動作が異なる場合があります。』