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型データの取得方法を次のどちらかで指定します。

lpctBLOBFileName

BLOB型データを格納するファイルのプレフィックスを指定します。

引数nBLOBTypeでTYPE_BLOB_FILEを指定した場合,BLOB型データを格納するファイルのプレフィックスには,この引数で指定した名称が使われます。TYPE_BLOB_FILE以外の値を指定した場合は,この引数での指定は無視されます。

BLOB型データを格納したファイル名称は,「プレフィックス+レコード番号+フィールド番号」で表されます。NULLが指定された場合,「DBConnectionの名称+DBPreparedStatementの名称」が仮定されます。

戻り値

なし

機能詳細

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

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

ファイル上でBLOB型データを扱う場合の制限事項

データの格納されているファイルは,DABrokerが終了しても削除されません。アプリケーション自身で削除してください。

作成されたファイルのアクセス権限は,アプリケーションの実行ユーザ及びデフォルトの権限に依存します。例えば,HP-UX上で"user1"が実行しているアプリケーションで,デフォルトumaskが0666の場合,取得したBLOB型データが格納されるファイルも,"user1"の所有する0666のアクセス権限が付与されたファイルとして生成されます。

発生する例外

DBSQLCA(RetCode)

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