16.12.2　SQLFreeHandle : Hitachi Advanced Data Binder AP開発ガイド

(1)　機能

特定の環境，接続，ステートメント，ディスクリプタのハンドルと関連づけられたリソースを解放します。

SQLRETURN SQLFreeHandle
(
  SQLSMALLINT     HandleType,        /* In */
  SQLHANDLE       Handle             /* In */
)

HandleType：

次のどれかのハンドルの種類を指定します。

Handle：

解放するハンドルを指定します。

この関数を実行する前にSQLAllocHandleの*OutputHandlePtrで出力された値を指定します。

SQL_SUCCESS，SQL_ERROR，またはSQL_INVALID_HANDLEが返されます。

この関数では次のSQLSTATEを返します。

SQLSTATE	説明	備考	返却
01000	一般警告	−	×
HY001	メモリ割り当てエラー	−	×
HY010	関数シーケンスエラー	すべての従属ハンドルとコネクションを含むほかのリソースが先に解放されていません。 HandleTypeがSQL_HANDLE_STMTですが，そのステートメントハンドルに対して非同期実行関数が終了していません。	○
HY013	メモリ管理エラー	−	×
HY017	自動的に割り当てられるディスクリプタハンドルの不正使用	−	×
HY092	無効な属性識別子，または無効なオプション識別子	HandleTypeに指定できない値が指定されました。	○
HYT01	接続タイムアウト終了	−	×
IM001	ドライバはこの関数をサポートしていない	−	×

（凡例）

○：HADB ODBCドライバが返すことがあるSQLSTATEです。

×：HADB ODBCドライバが返さないSQLSTATEです。

−：なし。