User manual - PPPライブラリ解説書ver.1.01(2003年2月7日)
DT-900 PPP ライブラリ解説書
- 23 -
int Nread(int conno, char *buff, int len)
コネクション"conno"から最長"len"サイズのメッセージを"buff"に読み込みます。
引数 int conno : コネクションナンバー。
char *buff : メッセージ格納バッファへのポインタ。
int len : メッセージ長。
戻り値 0を含む正の数 : リターンされた文字数。
-12 : タイムアウト。読み出しを再び試みます。
-14 : プロトコル関連の問題。アプリケーションは、コネクションをクローズす
る必要があります。
-16 : コネクションナンバーが無効です。
-18 : ノンブロッキングコネクションを処理することが出来ません。読み出し
は、再び試されています。
-19 : メッセージが長すぎて、バッファに格納出来ません。
-20 : 電源 ON/OFF あり。
-21 : 回線切断
-22 : ユーザーブレイク。
-23 : 内部エラー発生。
Nread マクロ
read マクロを使った場合、以下で示すように、コネクションの処理の融通性を高める事が出来ます。
SOCKET_RXTOUT(conno, tout) : コネクション"conno"に新しい読み出しのタイムアウトを tout mSEC で
指定します。
リターン値はありません。
SOCKET_HASDATA(conno) : コネクション"conno"のメッセージがあるかどうかテストします。メッセ
ージがある場合は、ゼロ以外の値を返します。
SOCKET_TESTFIN(conno) : コネクション"conno"がクローズされたかテストします。