RemoveConnectionメソッド

機能

DBConnectionオブジェクトを削除します。

形式

void RemoveConnection(LPCTSTR lpctName) throw DBSQLCA

引数

lpctName

削除するDBConnectionオブジェクトの名前を指定します。

戻り値

なし

機能詳細

引数lpctNameで指定した名前のDBConnectionオブジェクトを削除します。また,このDBConnectionオブジェクトで生成されたステートメントはすべて削除され,トランザクション中のコネクションがある場合はロールバックしてトランザクションを破棄します。

実行待ちステートメントがある場合(非同期処理),DBConnectionオブジェクトは削除できません。その場合は,実行待ち,及び実行中の処理の終了を確認してから,DBConnectionオブジェクトを削除してください。

なお,一時的にデータベースとの接続を切り離したい場合は,Closeメソッドが使えます。

発生する例外

DBSQLCA(RetCode)

DB_ERROR_CANNOT_BE_NULL
オブジェクトの名前にNULLを指定しています。
DB_ERROR_CANNOT_FIND_OBJECT
指定した名前を持つオブジェクトがありません。
DB_ERROR_IN_ASYNC_EXECUTE
SQLの非同期実行中です。
DB_ERROR_DRIVER_ERROR
DBMSでエラーが発生しました。
DB_ERROR_DAB_ACCESS_ERROR
DABrokerでエラーが発生しました。
DBSQLCAクラスで詳細コードを確認してください。
DB_ERROR_DAB_SYSTEMCALL_ERROR
システムコールでエラーが発生しました。
DBSQLCAクラスで詳細コードを確認してください。