GetResultSetメソッド

機能

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

形式

DBResultSet *GetResultSet (void) throw DBSQLCA

引数

なし

戻り値

データ型:DBResultSet*

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

機能詳細

Executeメソッドで指定されたSELECT文の検索結果を取得します。

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

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

同じSQLに対する2度目以降のGetResultSetの呼び出しは,既にあるDBResultSetオブジェクトへのポインタが返ります。

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

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

DBResultSetオブジェクトのポインタの有効期間

GetResultSetメソッドを呼び出して取得したDBResultSetオブジェクトのポインタは,次にExecuteメソッドを実行した時点で無効になります。このため,Executeメソッド実行後に検索結果を取得したい場合は,必ずGetResultSetメソッドを実行して新しいDBResulSetオブジェクトのポインタを取得してください。

発生する例外

DBSQLCA(RetCode)

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