Driverメソッド

機能

DBDriverオブジェクトを生成します。

DBDriverオブジェクトは,DBMSに接続するため情報を設定するオブジェクトで,接続するDBMSごとに生成します。

形式

DBDriver *Driver (LPCTSTR lpctAbstractName,
                 LPCTSTR lpctOptions = NULL,
                 UINT16 swTimeout = 0)          throw DBSQLCA

DBDriver *Driver (UNIT16 ui16Driver,
                 LPCTSTR lpctOptions = NULL,
                 UINT16 ui16Timeout = 0);       throw DBSQLCA

引数

lpctAbstractName

接続先データベース定義ファイルに記述のあるデータベース種別名を指定します。

指定した名称と同じ名前を持つDBDriverオブジェクトが既にある場合,そのオブジェクトのポインタを返します。

lpctOptions

DBMSにアクセスするときに,C++クラスライブラリを使ったトランザクション制御にするのか,TPBokerのOTSインタフェース,又はOpenTP1連携を使ったトランザクション制御にするのかを指定します。次のどちらかの値で設定します。

swTimeout

現在のバージョンでは値を指定しても意味を持ちません。指定を省略するか,0を指定します。

ui16Driver

次の列挙型の値を指定します。

ここに示した以外の値を指定した場合,動作は保証しません。

戻り値

データ型:DBDriver*

DBDriverオブジェクトへのポインタ。

機能詳細

データベースにアクセスするには,そのデータベースに接続することが必要です。通常,接続には接続先データベース定義ファイルで定義されている情報を使います。このメソッドでは,その情報のうち,データベース種別について引数lpctAbstractNameで指定します。

データベースにアクセスする際にトランザクション制御を,C++クラスライブラリ,又はTPBrokerのOTSインタフェースのどちらで行うかも指定します。

発生する例外

DBSQLCA(RetCode)

DB_ERROR_NOT_ENOUGH_MEMORY
メモリ容量が不足しています。
DB_ERROR_ARGUMENT_OUT_OF_RANGE
指定した引数が誤っています。
DB_ERROR_NOT_SUPPORTED
サポートされていないDBMSを指定しました。
DB_ERROR_CANNOT_BE_NULL
引数lpctAbstractNameにNULLを指定しました。
DB_ERROR_DBDEFINITIONNAME_LENGTH_IS_ZERO
引数lpctAbstractNameに空文字列を指定しました。
DB_ERROR_INITIALIZE_ERROR
メモリ不足もしくは環境設定の不正によって,処理を続行できません。
DB_ERROR_CANNOT_USE_XADRIVER
指定した非XAインターフェース用のデータベース種別名は,既にXAインターフェース用として使われています。
DB_ERROR_CANNOT_USE_NONXADRIVER
指定したXAインターフェース用のデータベース種別名は,既に非XAインターフェース用として使われています。
DB_ERROR_DBDEFINITIONNAME_IS_UNAVAILABLE_IN_XA
lpctAbstractNameにデータベース種別名が指定されていますが,lpctOptionsに"XA"が指定されています。