SQLDisconnect() - データ・ソースから切断する
SQLDisconnect() は、データベース接続ハンドルに関連付けられた接続をクローズします。この接続で未解決トランザクションがある場合は、SQLDisconnect() を呼び出す前に、SQLEndTran() を呼び出す必要があります。この関数を呼び出した後、SQLConnect() を呼び出して別のデータベースに接続するか、 あるいは SQLFreeHandle() を呼び出します。
SQLDisconnect() の ODBC 仕様
| ODBC 仕様レベル | X/Open CLI CAE 仕様 | ISO CLI 仕様 |
|---|---|---|
| 1.0 | あり | あり |
構文
SQLRETURN SQLDisconnect (SQLHDBC hdbc);
関数の引数
次の表は、この関数のそれぞれの引数ごとに、 データ・タイプ、用途、および説明を示しています。
| データ・タイプ | 引数 | 使用法 | 説明 |
|---|---|---|---|
| SQLHDBC | hdbc | 入力 | 接続をクローズするための接続ハンドルを指定します。 |
使用法
接続に関連したすべてのステートメント・ハンドルを解放する 前に SQLDisconnect() を呼び出すと、Db2® ODBC はデータベースからの切断が成功した後、 それらのステートメント・ハンドルを解放します。
SQL_SUCCESS_WITH_INFO が戻された場合は、たとえデータベースからの切断に成功しても、 追加のエラーまたはインプリメンテーション固有の情報があることを暗黙的に示しています。 例えば、切断以降の終結処理の際に問題が検出された場合、あるいはアプリケーションとは 無関係にイベントが発生 (通信障害など) したために現行接続が切断した 場合、SQLDisconnect() は SQL_SUCCESS_WITH_INFO を出します。
SQLDisconnect() の呼び出しが成功した後、引数 hdbc で指定した接続ハンドルを再利用して、別の SQLConnect() または SQLDriverConnect() 要求を行うことができます。
戻りコード
- SQL_SUCCESS
- SQL_SUCCESS_WITH_INFO
- SQL_ERROR
- SQL_INVALID_HANDLE
診断
次の表は、この関数が生成する各 SQLSTATE 値ごとに、 その記述と説明を一覧で記載してあります。
| SQLSTATE | 説明 | 説明 |
|---|---|---|
| 01002 | 切断エラーが発生しました。 | 切断の際にエラーが発生しました。 ただし、切断には成功しま した。SQLDisconnect は、この SQLSTATE で SQL_SUCCESS_WITH_INFO を戻します。 |
| 08003 | 接続はクローズされています。 | 引数 hdbc で指定された接続がオープンしていません。 |
| 25000 または 25501 | トランザクション状態が無効です。 | 引数 hdbc で指定した接続に対して、あるトランザクションが処理中です。
このトランザクションがアクティブ状態のため、接続を切断できません。
このエラーは、Db2 ODBC で作成されたストアード・プロシージャーには適用されません。 |
| 58004 | 予期しないシステム障害です。 | リカバリー不能なシステム・エラーです。 |
| HY001 | メモリーの割り振りに失敗しました。 | Db2 ODBC は、関数の実行または完了をサポートするのに必要なメモリーを割り振ることができません。 |
| HY010 | 関数シーケンス・エラーが発生しました。 | この関数は、実行時データの操作時に呼び出されました。(すなわち、SQLParamData() または SQLPutData() 関数を使用するプロシージャー実行中に関数が呼び出されました。) |
| HY013 | 予期しないメモリー処理エラーです。 | Db2 ODBC は、関数の実行または完了をサポートするのに必要なメモリーにアクセスできません。 |
例
関連例については、SQLDriverConnect() を参照してください。