Interstage Shunsaku Data Manager アプリケーション開発ガイド - Microsoft(R) Windows(R) 2000/ Microsoft(R) Windows Server(TM) 2003 - - UNIX共通 -

11.1.1 ハンドルの使用方法

ハンドルの使用方法について説明します。

■処理の流れ

コネクションの確立から切断までの、処理シーケンスの推奨パターンを以下に示します。

[図: コネクション確立から切断までの処理の流れ]

◆(1) コネクションハンドルの割当て

ShunAllocHandle関数で、コネクションハンドルを割り当てます。これにより、コネクションハンドルは利用可能な状態となります。

◆(2) コネクションの確立

コネクションハンドルを割り当てた後、ShunConnect関数でShunsakuとのコネクションを確立します。

◆(3) データ操作ハンドルの割当て

コネクションの確立後、ShunAllocHandle関数でデータ操作ハンドルを割り当てます。

これにより、データ操作ハンドルは利用可能な状態となり、Shunsakuに対してデータの検索および更新ができます。

◆(4) データ操作ハンドルの解放

ShunFreeHandle関数で、データ操作ハンドルを解放します。データ操作ハンドルを解放すると、そのハンドルが持つリソース（レコードID、データ、位置情報、ダイレクトアクセスキー）も解放されます。

◆(5) コネクションの切断

ShunDisconnect関数で、コネクションを切断します。

◆(6) コネクションハンドルの解放

ShunFreeHandle関数で、コネクションハンドルを解放します。指定したハンドルのコネクションが確立されている場合は、そのコネクションは切断されます。

■注意事項

• データ操作ハンドルを割り当てることができる期間

  データ操作ハンドルを割り当てることができるのは、コネクションの確立後からコネクションを切断するまでです。それ以外のタイミングでデータ操作ハンドルを割り当てようとすると、SHUN_ERRORが返却されます。

• データ操作ハンドルが解放されるタイミング

  データ操作ハンドルを解放せずにコネクションを切断すると、そのコネクション内で割り当てたデータ操作ハンドルはすべて解放されます。データ操作ハンドルで保持しているリソースをコネクションの切断後も利用する場合は、別の領域にコピーしてください。

• 通信異常が発生した場合のデータ操作ハンドルの状態

  通信異常が発生し、コネクションの確立から再実行すると、そのコネクション内で割り当てたデータ操作ハンドルはすべて解放されます。再度コネクションを確立したあとに、データ操作ハンドルを割り当ててください。