ほかのネットワークユーザに対して，コネクション接続を要求します。

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

(a)　fd

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

(b)　sndcall

コネクションを確立するために必要な情報を指定します。

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

• VCの場合
  

  addr：

  相手のネットワークアドレス情報を指定します。ネットワークアドレスについては，「7.1　ネットワークアドレス」を参照してください。

  opt：

  ネットワークプロトコルオプションを指定します。ただし，パケットサイズは，自局の構成定義で設定した値以下でなければなりません。優先データの使用については，「11.1　優先データ受信機能」を参照してください。

  udata：

  コールユーザデータを指定します。コールユーザデータの使用については，「11.2　コールユーザデータの転送機能」を参照してください。

  sequence：

  設定しても，NLIで無視されます。

• PVCの場合
  設定しても，NLIで無視されます。
  

(c)　rcvcall

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

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

(a)　リターンコード

0：正常終了

-1：異常終了

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

(b)　rcvcall

• VCの場合
  

  addr：

  コネクション確立着信側のネットワークアドレスが設定されます。

  opt：

  コネクション確立着信側が指定したネットワークプロトコルオプションが設定されます。プロトコルオプションとして，パケットサイズと優先データ使用有無が設定されます。プロトコルオプションについては，「8.　ネットワークプロトコルオプション」を参照してください。

  udata：

  コールユーザデータが設定されます。コールユーザデータの使用については，「11.2　コールユーザデータの転送機能」を参照してください。

  sequence：

  設定されません。

• PVCの場合
  

  addr：

  LCIなどの情報が設定されます。ここに設定される情報の形式については，「7.1　ネットワークアドレス」を参照してください。

  opt：

  設定されません。

  udata：

  設定されません。

  sequence：

  設定されません。

1. 非同期モードで動作している場合，n_connectは遠隔ユーザの応答を待たないですぐにリターンします。その場合，-1でリターンして，n_errnoにはNNODATAが設定されます。同期モードで動作している場合，相手のネットワークユーザの応答を待ってからリターンします。
2. udataフィールドの１バイト目は，通信システム内で調整されているプロトコル識別子（SPI）を指定します。