ステートメント・ハンドルを解放する関数
SQLFreeHandle() 関数 (HandleType を SQL_HANDLE_STMT に設定) を呼び出して、特定のステートメント・ハンドルの処理を終了します。
また、SQLFreeHandle() は以下のタスクも実行します。
- 結果セットのすべての列のアンバインド
- すべてのパラメーター・マーカーのアンバインド
- カーソルのクローズとペンディング結果の廃棄
- ステートメント・ハンドルのドロップ、およびすべての関連リソースの解放
ステートメント・ハンドルは、ドロップされていない限り、他の ステートメントで再利用できます。 ステートメント・ハンドルを別の SQL ステートメント・ストリングで再利用する場合は、 キャッシュされている元のステートメントのアクセス・プランはすべて廃棄されます。
ハンドルを使用して、異なる数または異なるタイプのパラメーター、あるいは 異なる結果セットを用いてステートメントを処理する前に、必ず、列およびパラメーターを アンバインドしておく必要があります。 そのようにしないとアプリケーション・プログラミング上のエラーが起こることがあります。