Btrieve API Guide (v11)

Stop(25)

Stop オペレーション(B_STOP)では、クライアントに対していくつかの終了ルーチンを実行します。終了ルーチンには、すべてのロックを解除する、開いているファイルでそのクライアントに関連付けられているファイルをすべて閉じるなどのルーチンがあります。

パラメーター

 
オペレーション コード
ポジション ブロック
データ バッファー
データ バッファー長
キー バッファー
キー番号
送り値

 
 
 
 
 
戻り値
 
 
 
 
 
 

手順

オペレーション コードに 25 を設定します。

結果

Stop オペレーションが正常に終了した場合、トランザクショナル インターフェイスでは次のような動作が実行されます。

  1. 実行中のトランザクションがすべて中止される。
  2. クライアントによって保持されているすべてのロックが解除されます。
  3. クライアントが開いているファイルがすべて閉じられます。
  4. ほかのクライアント(トランザクショナル インターフェイスに登録されているほかのアプリケーション)が存在しない場合、トランザクショナル インターフェイスの設定にもよりますが、トランザクショナル インターフェイスの実行が終了し、いくつかのリソースが解放されます。

Stop オペレーションが正常に実行されなかった場合は、トランザクショナル インターフェイスから 0 以外のステータス コードが返されます。最もよくあるのはステータス コード 20(MicroKernel または Btrieve リクエスターが非アクティブ)です。このステータスは、トランザクショナル インターフェイスまたはリクエスターがロードされていないために発生します。

ポジショニング

Stop オペレーションを実行すると、開いているファイルがすべて閉じられるため、すべてのカレンシーが消去されます。


Step Previous Extended(39)

Unlock(27)