CreatePreparedStatementメソッド

機能

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

DBPreparedStatementオブジェクトは,?パラメタを使ったSQL文を実行するためのオブジェクトです。

形式

DBPreparedStatement *CreatePreparedStatement
                         (LPCTSTR lpctStatement,
                          LPCTSTR lpctName = NULL) throw DBSQLCA

引数

lpctStatement

0個以上の?パラメタを含んだSQL文を指定します。

lpctName

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

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

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

戻り値

データ型:DBPreparedStatement*

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

機能詳細

?パラメタを含むSQL文を組み立て,このメソッドを呼び出してDBPreparedStatementオブジェクトを生成します。

なお,引数lpctStatementでNULL以外の値を指定して,既にあるオブジェクトと同じ名称を指定した場合はエラーをスローします。SQLの実行方法については「2.6 詳細版クラスのデータベースアクセス」を参照してください。

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

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

発生する例外

DBSQLCA(RetCode)

DB_ERROR_NOT_ENOUGH_MEMORY
メモリ容量が不足しています。
DB_ERROR_NOT_CONNECTED
DBに接続していません。
DB_ERROR_INVALID_ARGUMENT
新規生成時に,既に使われているオブジェクト名称を指定しています。
DB_ERROR_DRIVER_ERROR
DBMSでエラーが発生しました。
DB_ERROR_NAME_ALREADY_USED
指定した名称は既に使用されています(非同期実行時)。
DB_ERROR_CANNOT_FIND_OBJECT
指定した名前を持つオブジェクトがありません。
DB_DRV_ERROR_STAT_COUNT
ステートメントの個数が上限値を超えました。