名称

 jsna3270_free_buffer − jsna3270_receive_stream によって割り当てられた バッファを解放する。

形式

#include <sna/jsna3270.h>

jsna3270_free_buffer (session_id, buf, status_vec)

SESSION_ID_DEF session_id;
char ∗buf;
STATUS_RTN status_vec[];

引数

session_id 接続時に割り当てられたセッション識別子。

buf OSF/1 アプリケーションが jsna3270_receive_stream プロシージャを呼び出した ときに，割り当てられたバッファ・ポインタのアドレス。

status_vec OSF/1 アプリケーションがメモリを割り当てて，日本語 3270 DSPI がユーザに 完全なステータス情報を提供するために使用する，データ・タイプ STATUS_RTN で， 長さ SNA3270_C_SV_SIZE のベクタ。最初のエントリ（status_vec[0]）には， ベクタの中で返されるステータス・コード数が入っている。

機能説明

jsna3270_free_buffer プロシージャを呼び出すことによって，日本語 3270 DSPI は，それ以前に jsna3270_receive_stream プロシージャによって割り当てられたバッファ領域を 解放します。

戻り値

jsna3270_free_buffer プロシージャは，次のステータスを返します。

[SNA3270_S_OK] 成功。

[SNA3270_S_SVOMIT] ステータス・ベクタが割り当てられていない。

[SNA3270_S_NOSUCHSOCK]
無効なセッション識別子。

[SNA3270_S_FREEFAI] バッファの解放に失敗。詳細は，ステータス・ベクタを参照。

診断項目

呼び出しに失敗したときには，プロシージャはステータス・ベクタの中に関連 コード（1 つまたは複数）を返します。

制限事項

なし

関連項目

jsna3270_receive_stream(3) プロシージャも参照してください。