SetParamメソッド

機能

IN/OUT,INパラメタの値を設定します。

形式

void SetParam(UINT32 dwIndex,LPCTSTR lpctParam) throw DBSQLCA
void SetParam(UINT32 dwIndex,INT16 sParam) throw DBSQLCA
void SetParam(UINT32 dwIndex,INT32 lParam) throw DBSQLCA
void SetParam(UINT32 dwIndex,UINT16 swParam) throw DBSQLCA
void SetParam(UINT32 dwIndex,UINT32 dwParam) throw DBSQLCA
void SetParam(UINT32 dwIndex,SINGLE sfParam) throw DBSQLCA
void SetParam(UINT32 dwIndex,DOUBLE dfParam) throw DBSQLCA
void SetParam(UINT32 dwIndex,const DBR_DATETIME& dtParam)
                                             throw DBSQLCA
void SetParam(UINT32 dwIndex,const DBR_BINARY& blobParam)
                                             throw DBSQLCA

引数

指定されたパラメタを,データベースの型にキャストして設定します。

dwIndex

1から始まるパラメタの番号を指定します。指定するパラメタの番号は,SQL文中での出現順に割り当てられます。

xxParam(データ型:形式の第2引数を参照してください)

パラメタに設定する値を指定します。

戻り値

なし

機能詳細

指定されたパラメタの値を設定します。プロシジャの定義でIN/OUT,INで宣言したパラメタのうち,SetProcedureメソッドの引数lpctProcedureで指定した?パラメタに値を設定します。

値は指定するデータ型からデータベース固有の型に変換されます。

SetParamメソッドはSetProcedureメソッドを実行した後に実行してください。

引数lpctParamがNULL(LPCTSTR型の変数にNULLを代入して引数に渡した場合,又はNULLをLPCTSTR型にキャストした場合)の時も欠損値が設定されます。キャストしないで引数にNULLだけを指定した場合は欠損値とはみなしません。

パラメタに欠損値を設定したい場合は,SetNullメソッドを使用してください。

DBR_BINARY型を指定する場合

DBR_BINARY型の各メンバには次の値を設定します。

Length:設定するデータの長さ(単位はバイト)

RealLength:設定不要

Data:実際のデータの領域を指すポインタ

発生する例外

DBSQLCA(RetCode)

DB_ERROR_ARGUMENT_OUT_OF_RANGE
引数dwIndexの範囲が不正です。
DB_ERROR_IN_ASYNC_EXECUTE
ステートメントが非同期実行処理中です。
DB_ERROR_PROCEDURE_NOT_SET
実行するプロシジャが指定されていません。