BT_CANL( )
 

受信要求を，キャンセルします。

#include <dlicom/bsc.h> int BT_CANL(fd); int fd;

受信要求による受信待ち状態をキャンセルします。受信要求を取り消して送信要求に切り替えるときに使います。

BT_CANL関数は，BT_RINI関数，またはBT_RTXT関数の待ち状態で発行すると，待ち状態をキャンセルして，回線オープンの状態に戻します。そのほかの状態で発行した場合は無視されます。

fdには，ドライバをオープンしたときにリターン値として返される回線識別子を指定します。

(a)　リターン値

0：正常終了

-1：異常終了

(b)　詳細エラー情報

名称	値	要因
ENXIO	6	通信管理が開始していません。
EBUSY	16	同じ回線に対して，すでにキャンセル処理中です。
上記以外		AIXマニュアルのioctlシステムコールを参照してください。

• 同期方式のBT_RINI関数またはBT_RTXT関数をキャンセルする場合は，BT_RINI関数またはBT_RTXT関数を発行したプロセスの子プロセスから，BT_CANL関数を発行してください。
• 非同期方式のBT_RINI関数またはBT_RTXT関数をキャンセルする場合は，BT_RINI関数またはBT_RTXT関数を発行したプロセスから，BT_CANL関数を発行できます。
  BT_CANL関数を発行した場合でも，非同期方式のBT_RINI関数またはBT_RTXT関数の結果をBT_CHECK関数で取り込む必要があります。BT_CHECK関数でのLCBの設定は，「3.26　LCB」および「3.27　ライブラリ関数とインタフェース構造体の関係」を参照してください。
  
• BT_CANL関数を発行したときに，すでにBT_RINI関数またはBT_RTXT関数が完了している場合，キャンセルは失敗し，BT_RINI関数またはBT_RTXT関数は正常に完了します。この場合，BT_CANL関数は正常終了します。BT_RINI関数またはBT_RTXT関数のリターン値によって，結果を判断する必要があります。