PowerSORT Workstation V5.0 使用手引書

6.3.2 bsrtclse関数

bsrtclse関数は、bsrtopen関数が構築したPowerSORTの実行環境を消去します。

■記述形式

#include "bsrt.h"
int bsrtclse (long int BSRTVL, BSPTR_BSRTFUNC func,
　　　　　　　 BSPTR_BSRTPRIM prim, BSPTR_BSRTREC rec);

■機能説明

以下にbsrtclse関数の機能を示します。

• bsrtopen関数が構築したPowerSORTの実行環境を消去します(作業域の開放、入出力ファイルと一時ファイルのクローズなど)。
• bsrtopen関数でロードしたPowerSORTのダイナミックリンクライブラリ(DLL)を仮想記憶域から消去します。
• bsrtget関数、bsrtput関数の処理の途中でbsrtclse関数を呼んだときに処理を中断します。

■パラメタ詳細

◆long int BSRTVL

PowerSORTのバージョンレベル(BSRTVL)を指定します。
BSRTVLはBSORT関数のヘッダファイル(bsrt.h)で定義されています。

◆BSPTR_BSRTFUNC func

bsrtopen関数で指定したfuncを指定します。なお、BSPTR_BSRTFUNCは、BSRTFUNC構造体のポインタを意味します。

◆BSPTR_BSRTPRIM prim

bsrtopen関数で指定したprimを指定します。なお、BSPTR_BSRTPRIMは、BSRTPRIM構造体のポインタを意味します。

◆BSPTR_BSRTREC rec

bsrtopen関数で指定したrecを指定します。なお、BSPTR_BSRTRECは、BSRTREC構造体のポインタを意味します。

■復帰値

bsrtclse関数の復帰値を説明します。

復帰値	意味
0	正常にbsrtclse関数が終了しました。
1	処理の中断を指示され、正常に中断処理が終了しました。 次のような状態のときにbsrtclse関数を発行すると処理を中断します。 ユーザアプリケーションが、bsrtput関数またはbsrtmrge関数でデータの終わりを通知していない状態 ユーザアプリケーションに、bsrtget関数またはbsrtmrge関数がデータの終わりを通知していない状態
-1	bsrtclse関数の処理で異常が発生したことを示します。 BSRTREC構造体のerrdetailまたはsub_error_codeに詳細コードが設定されます。

bsrtclse関数のパラメタには、ユーザアプリケーションが新しく設定するメンバはありません。