GetResultSetメソッド

機能

SQL文を実行し,検索したレコードから,ResultSetオブジェクトを生成します。

形式

DBResultSet *GetResultSet (void) throw DBSQLCA

引数

なし

戻り値

データ型:DBResultSet*

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

機能詳細

?パラメタを付けたSELECT文の検索結果を取得します。SELECT文はDBPreparedStatementオブジェクトの生成時に指定したものです。

データベースからSetMaxRowsメソッドで指定されたレコード数分レコードを検索後,DBResultSetオブジェクトを生成し,生成したオブジェクトへのポインタを返します。

GetResultSetメソッドを呼び出す前に,Executeメソッドを呼び出し,SetParamメソッドを呼び出してパラメタの値を設定しておきます。SetParamメソッドで値を設定していないパラメタはNULL値と解釈して実行します。

Executeメソッドで実行したSQLがSELECT文でない場合はNULLを返します。

BLOB型データを扱う場合の制限事項については,SetResultSetTypeメソッド,及び「3.3.4 BLOB型データの取得方法についての制限」を参照してください。

このメソッドは,非同期実行可能なメソッドです。

XDM/RDの場合

GetResultSetメソッドを呼び出す前に,すべてのパラメタについてSetParamTypeメソッドでデータ型を設定しておいてください。

発生する例外

DBSQLCA(RetCode)

DB_ERROR_NOT_ENOUGH_MEMORY
メモリ容量が不足しました。
DB_ERROR_BEFORE_EXECUTE
Executeメソッドが実行されていません。
DB_ERROR_DRIVER_ERROR
DBMSでエラーが発生しました。
DB_ERROR_DAB_ACCESS_ERROR
DABrokerでエラーが発生しました。
DBSQLCAクラスで詳細コードを確認してください。
DB_ERROR_DAB_SYSTEMCALL_ERROR
システムコールでエラーが発生しました。
DBSQLCAクラスで詳細コードを確認してください。
DB_DRV_ERROR_RDA_PARAM_TYPE
パラメタのデータ型が設定されていないか,又は設定されたデータ型が不正です。
DB_ERROR_TIMEOUT
タイムアウトが発生したため制御を戻します。
DB_DRV_ERROR_REQUEST_RESULTSET_ROWS
ResultSetを生成するために指定されたレコード数が不正です。SetMaxRowsメソッドで正しいレコード数を指定してください。