4.4.2 DF CLOSE

DFインタフェースの使用終了宣言

【呼出形式（C）】

UINT  XWSIAPI 
XWSI_DF_CLOSE(ReqHandle, ws_errno)

USHORT      ReqHandle      リクエストハンドル
UINT       *ws_errno       処理結果

【機能】

DUETファイル転送インタフェースの使用を終了します。

【引数】

ReqHandle	WSMGR OPENコマンドによって得られたリクエストハンドル。
ws_errno	処理結果を格納する領域のアドレス。

【関数返却値】

XWSIWSAPI_GOOD	(0)	WSAPI が正常に処理されました。
XWSIWSOS_ERR	(1)	WSMGR でWindows API コールを行いその結果エラーになった場合、設定されます。また、そのとき受け取ったエラーコードをws_errno に格納します。
XWSIWSAPI_ERR	(2)	WSAPI が異常で終了したことを示します。エラー詳細は、ws_errno に格納されます。

【出力】

ws_errno

関数返却値＝ XWSIWSOS_ERR (1) のとき
Windows API コールから返されるエラーコードが格納されます。
エラーコードはWin32エラーコードが返ります。

関数返却値＝ XWSIWSAPI_ERR (2) のとき
WSAPI のエラーコード一覧を参照してください。

関数返却値＝ XWSIWSAPI_GOOD (0) のとき
意味を持たないのでアプリケーションで参照する必要はありません。

【注意事項】

DFインタフェースが使用可能状態のときに回線切断が発生した場合、DF_CLOSEを発行すると、ファイル転送制御がエラー4014（DFインタフェースが異常終了しました）を返すため、DFインタフェースの資源解放が行われません。資源解放を行うには、もう一度DF_CLOSEを発行してください。これによりDF_CLOSEは"XWSIWSAPI_GOOD"を返し、正常に終了します。