CreateCallableStatementメソッド

機能

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

DBCallableStatementオブジェクトはストアドプロシジャの実行を管理します。

形式

DBCallableStatement *CreateCallableStatement
                        (LPCTSTR lpctName = NULL) throw DBSQLCA

引数

lpctName

生成するDBCallableStatementオブジェクトの名前,又はNULLを指定します。

NULLを指定する,又は指定を省略すると,DABrokerが名前を自動生成して,DBCallableStatementオブジェクト生成し,オブジェクトへのポインタを返します。

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

戻り値

データ型:DBCallableStatement*

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

機能詳細

DBCallableStatementオブジェクトを生成し,オブジェクトのポインタを返します。

ストアドプロシジャを実行するためには,このDBCallableStatementオブジェクトを使います。

ストアドプロシジャの実行方法については「2.6.6 ストアドプロシジャの利用」を参照してください。

生成できるDBCallableStatementオブジェクトの個数には制限があります。詳細については「3.3.2 データベースアクセスリソース数の制限」を参照してください。

自動的に生成されるオブジェクト名については「3.3.1 オブジェクトの生成と削除」を参照してください。

発生する例外

DBSQLCA(RetCode)

DB_ERROR_NOT_ENOUGH_MEMORY
メモリ容量が不足しています。
DB_ERROR_NOT_CONNECTED
データベースに接続していません。
DB_ERROR_DRIVER_ERROR
DBMSでエラーが発生しました。
DB_DRV_ERROR_STAT_COUNT
ステートメントの個数が上限値を超えました。