SetResultSetTypeメソッド

機能

DBResultSetオブジェクトの生成オプションを指定します。

DBResultSetオブジェクトを生成するときに,参照専用,又は更新可能のどちらで生成するか選択します。検索レコードに対するロック方法を指定します。

検索時にバッファを幾つ使うかも指定できます。

また,BLOB型データを扱う場合,その取得方法についても指定します。

形式

void SetResultSetType (UINT16 swType = TYPE_EXCLUSIVE|BUFFER_TYPE_SINGLE,
                      DBR_BLOB_TYPE nBLOBType = TYPE_BLOB_MEMORY,
                      LPCTSTR lpctBLOBFileName = NULL)
                                                   throw DBSQLCA

引数

swType

次の三つの値を指定します。

指定する値は,上記三つの値の論理和になります。

このメソッドを実行しなかった場合の動作は,TYPE_EXCLUSIVE | BUFFER_TYPE_SINGLE | VARCHAR_LENGTH_DEFを指定した場合と同じになります。

検索したレコードに対するロック方法
次に示すTYPE_EXCLUSIVE,TYPE_EXCLUSIVE2,TYPE_NONE,TYPE_WAIT,TYPE_NOWAIT,TYPE_SHAREDのどれかの値で,検索したレコードに対するロック方法を指定します。
検索時に使用するバッファ数
次に示すBUFFER_TYPE_SINGLE,又はBUFFER_TYPE_DOUBLEのどちらかの値で,検索時に使用するバッファ数を指定します。指定を省略した場合は,BUFFER_TYPE_SINGLEが仮定されます。なお,バッファの利用方法については,「3.3.3 検索性能の向上策」を参照してください。
VARCHARデータをDBR_BINARY型で取得したときのLengthメンバ,RealLengthメンバの意味
次に示す値のどれか一つを指定します。

nBLOBType

BLOB型データを取得するときは次の方法を使います。

戻り値

なし

機能詳細

検索レコードに対するロック方法,検索時にバッファを幾つ使うか,及びBLOB型データの取得方法について指定します。

指定した各引数の値は,次にGetResultSetメソッドを実行したときから有効になります。

このメソッドは,アクセスするDBMSがSQL Anywhere,Adaptive Server Anywhereの場合だけ利用できます。

発生する例外

DBSQLCA(RetCode)

DB_ERROR_ARGUMENT_OUT_OF_RANGE
引数が指定できる範囲を超えています。
DB_ERROR_NOT_ENOUGH_MEMORY
メモリ容量が不足しています。