ステートメント・ハンドルを解放する関数

SQLFreeHandle() 関数 (HandleType を SQL_HANDLE_STMT に設定) を呼び出して、特定のステートメント・ハンドルの処理を終了します。

また、SQLFreeHandle() は以下のタスクも実行します。
  • 結果セットのすべての列のアンバインド
  • すべてのパラメーター・マーカーのアンバインド
  • カーソルのクローズとペンディング結果の廃棄
  • ステートメント・ハンドルのドロップ、およびすべての関連リソースの解放

ステートメント・ハンドルは、ドロップされていない限り、他の ステートメントで再利用できます。 ステートメント・ハンドルを別の SQL ステートメント・ストリングで再利用する場合は、 キャッシュされている元のステートメントのアクセス・プランはすべて廃棄されます。

ハンドルを使用して、異なる数または異なるタイプのパラメーター、あるいは 異なる結果セットを用いてステートメントを処理する前に、必ず、列およびパラメーターを アンバインドしておく必要があります。 そのようにしないとアプリケーション・プログラミング上のエラーが起こることがあります。