名前

tpdiscon()−会話型サービスの接続を切断するルーチン

形式

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

機能説明

tpdiscon() は、cd で指定された接続をただちに切断し、接続の他方の側で TPEV_DISCONIMM イベントを生成します。

tpdiscon() は、会話の起動側からしか呼び出せません。tpdiscon() は、呼び出しに使用された記述子に対応する会話型サービス内からは呼び出せません。会話型サービスは tpreturn() を使用して、会話の該当部分が完了したことを通知しなければなりません。同様に、会話型サービスとのやりとりを行うプログラムが tpdiscon() を呼び出す場合でも、そのサービスに tpreturn() で接続を切断するようにしてください。これによって、正しい結果が得られます。

tpdiscon() を使用すると、接続はただちに切断されます (すなわち、正常終了ではなく、アボート)。したがって、宛先に届いていないデータは失われます。tpdiscon() は、接続の他方の側のプログラムが呼び出し元のトランザクションに参加している場合でも発行されます。この場合、このトランザクションはアボートします。また、呼び出し元は、tpdiscon() が呼び出されるときにその接続の制御権をもっている必要はありません。

戻り値

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

エラー

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

関連項目