【呼出形式(C)】
UINT XWSIAPI XWSI_DF_SETPARA(ReqHandle, ws_errno, trns_direction, df_param) USHORT ReqHandle リクエストハンドル UINT *ws_errno 処理結果 USHORT trns_direction 送受信区別 XWsiDfParam *df_param ファイル転送パラメータ
【機能】
ファイル転送に必要な情報を設定します。ファイル転送を中止する場合は、DF CANCEL を発行してください。DF WAITSTART完了後、有効となります。
【引数】
ReqHandle | WSMGR OPENコマンドによって得られたリクエストハンドル。 | ||||||
ws_errno | 処理結果を格納する領域のアドレス。 | ||||||
trns_direction | 送受信区別 | ||||||
XWSIDF_RECV | (0) | 受信 | |||||
XWSIDF_SEND | (1) | 送信 | |||||
df_param | ファイル転送パラメータ | ||||||
1)file_form | ファイル形式。 | ||||||
XWSIDF_TEXT | (1) | TEXT | |||||
XWSIDF_BINARY | (2) | BINARY | |||||
2)file_name | 転送/格納ファイル名。 | ||||||
3)save_form | 格納形式(受信時のみ有効)。 | ||||||
XWSIDF_UPDATE | (1) | 新規、入れ替え | |||||
XWSIDF_ADD | (2) | 追加 | |||||
4)code_type | コード変換指定。 | ||||||
XWSIDF_EBCALPH | (1) | EBCDIC 英小文字 | |||||
XWSIDF_EBCKANA | (2) | EBCDIC カナ有り | |||||
XWSIDF_STUP | (3) | CONNECT で指定したセットアップファイルに設定されているコード種別 | |||||
XWSIDF_EBCASCI | (4) | EBCDIC ASCII | |||||
5)rec_form | レコード形式(テキストファイル送信時のみ有効)。 | ||||||
XWSIDF_FIX | (1) | 固定長 | |||||
XWSIDF_VARIABLE | (2) | 可変長 | |||||
6)rec_length | レコード長(送信時のみ有効)。 | ||||||
7)tabset | タブ指定(テキストファイル送信時のみ有効)。 | ||||||
8)compact | システムリザーブ。 | ||||||
9)udc_block | 漢字変換指定 | ||||||
10)exkanji | システムリザーブ。 |
【関数返却値】
XWSIWSAPI_GOOD | (0) | WSAPI が正常に処理されました。 |
XWSIWSOS_ERR | (1) | WSMGRでWindows API コールを行いその結果エラーになった場合、設定されます。また、そのとき受け取ったエラーコードをws_errno に格納します。 |
XWSIWSAPI_ERR | (2) | WSAPI が異常で終了したことを示します。 |
【出力】
ws_errno | 関数返却値 = XWSIWSOS_ERR (1) のとき 関数返却値 = XWSIWSAPI_ERR (2) のとき 関数返却値 = XWSIWSAPI_GOOD (0) のとき |