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)