10.3 RECEIVE

<この節の構成>
(1) 機能概要
(2) 書き方
(3) リターン情報
(4) 特記事項

(1) 機能概要

アソシエーションの確立応答の受信,アソシエーションの解放指示の受信,ROSEデータの受信,およびPLデータの受信を行います。なお,同期型の要求の場合,受信データがあれば受信処理はすぐに完了しますが,受信データがなければ到着するまで待ちます。

(2) 書き方

#include <xnfw/xnf.h>              /* ヘッダ情報取り込み */
  struct cd_s rbuf;               /* 通信記述部の領域確保 */
  int rcode;                      /* リターンコード */
  rbuf.O_vpart1.O_mode=O_SYN;     /* 通信記述部の設定 */
  ..........................         .................
  rbuf.O_vpart2.O_bflen=BFLEN;    /* 通信記述部の設定 */
  rcode=xnf_rcv(&rbuf);           /* 関数呼び出し */

(3) リターン情報

(a) リターンコード

正の整数:指定した受信バッファ長不足のため,不足分のデータを読み捨てた

0:正常終了

-1:異常終了

(b) 詳細エラー情報

詳細エラー情報は,リターンコードが異常終了のときに,グローバル変数のerrnoに設定されます。詳細エラー情報については,「11. 詳細エラー情報」を参照してください。

(c) 詳細エラーコード

詳細エラーコードは,リターンコードが異常終了でerrno=EINVALのときに,通信記述部のO_statusに設定されます。詳細エラーコードについては,「12. 詳細エラーコード」を参照してください。

(4) 特記事項