SQLDisconnect() - データ・ソースから切断する

SQLDisconnect() は、データベース接続ハンドルに関連付けられた接続をクローズします。この接続で未解決トランザクションがある場合は、SQLDisconnect() を呼び出す前に、SQLEndTran() を呼び出す必要があります。この関数を呼び出した後、SQLConnect() を呼び出して別のデータベースに接続するか、 あるいは SQLFreeHandle() を呼び出します。

SQLDisconnect() の ODBC 仕様

表 1. SQLDisconnect() の仕様
ODBC 仕様レベル X/Open CLI CAE 仕様 ISO CLI 仕様
1.0 あり あり

構文

SQLRETURN   SQLDisconnect    (SQLHDBC           hdbc);

関数の引数

次の表は、この関数のそれぞれの引数ごとに、 データ・タイプ、用途、および説明を示しています。

表 2. SQLDisconnect() の引数
データ・タイプ 引数 使用法 説明
SQLHDBC hdbc 入力 接続をクローズするための接続ハンドルを指定します。

使用法

接続に関連したすべてのステートメント・ハンドルを解放する 前に SQLDisconnect() を呼び出すと、Db2® ODBC はデータベースからの切断が成功した後、 それらのステートメント・ハンドルを解放します。

SQL_SUCCESS_WITH_INFO が戻された場合は、たとえデータベースからの切断に成功しても、 追加のエラーまたはインプリメンテーション固有の情報があることを暗黙的に示しています。 例えば、切断以降の終結処理の際に問題が検出された場合、あるいはアプリケーションとは 無関係にイベントが発生 (通信障害など) したために現行接続が切断した 場合、SQLDisconnect() は SQL_SUCCESS_WITH_INFO を出します。

SQLDisconnect() の呼び出しが成功した後、引数 hdbc で指定した接続ハンドルを再利用して、別の SQLConnect() または SQLDriverConnect() 要求を行うことができます。

戻りコード

SQLDisconnect() は、呼び出された後、次のいずれかの値を戻します。
  • SQL_SUCCESS
  • SQL_SUCCESS_WITH_INFO
  • SQL_ERROR
  • SQL_INVALID_HANDLE

診断

次の表は、この関数が生成する各 SQLSTATE 値ごとに、 その記述と説明を一覧で記載してあります。

表 3. SQLDisconnect() の 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() を参照してください。