5.3.12 n_listen

<この項の構成>
(1) 機能概要
(2) 構文
(3) 設定情報
(4) リターン情報
(5) 特記事項

(1) 機能概要

ほかのネットワークユーザからのコネクション確立指示の到着を待ちます。

(2) 構文

#include <xnfw/niuser.h>
rcode = n_listen(fd, call);
int rcode, fd;
struct n_call *call;

(3) 設定情報

(a) fd

ネットワーク端点を指定します。

(b) call

コネクションの情報を受け取るエリアを指定します。

n_call構造体の参照内容については,「表10-10 インタフェース構造体(n_call)のパラメタの設定・参照(その1)」を参照してください。

(4) リターン情報

(a) リターンコード

0:正常終了

-1:異常終了

エラー番号がn_errnoに設定されています。エラー番号の詳細は,「9.1 エラー番号一覧」を参照してください。

(b) call

(5) 特記事項

n_listenは,非同期モードで動作している場合,相手からのコネクション接続指示が到着していないと-1でリターンし,n_errnoにNNODATAが設定されます。同期モードで動作している場合,相手からのコネクション接続指示が到着するまでリターンしません。