19.4.4　a_rdb_SQLBindParams()（？パラメタの関連づけ）

(1)　機能

SQL文中の？パラメタの値を設定する領域の結合（関連づけ）を行います。

ページの先頭へ

(2)　形式

signed short a_rdb_SQLBindParams
(
  void                          *ConnectionHandle,   /* In  */
  void                          *StatementHandle,    /* In  */
  unsigned short                 ParameterCount,     /* In  */
  a_rdb_SQLParameterInfo_t      *ParameterInfo,      /* In  */
  void                          *Option              /* In  */
)

ページの先頭へ

(3)　引数の説明

ConnectionHandle：

コネクションハンドルを指定します。

StatementHandle：

文ハンドルを指定します。

ParameterCount：

値を与える？パラメタの数を指定します。

a_rdb_SQLNumParams()で取得した？パラメタの数を指定してください。

ParameterInfo：

値格納用領域のアドレスを設定するパラメタ情報領域の先頭アドレスを指定します。

a_rdb_SQLParameterInfo_t構造体をParameterCountに指定した数だけ連続させた領域を用意してください。

a_rdb_SQLParameterInfo_t構造体については，「19.7.5　a_rdb_SQLParameterInfo_t構造体（パラメタ情報）」を参照してください。

Option：

NULLを指定します。

ページの先頭へ

(4)　戻り値

1. a_rdb_SQLBindParams()が正常に終了した場合，a_rdb_RC_SQL_SUCCESSが返却されます。

2. ？パラメタの関連づけには成功したが，クライアントメッセージログファイルを格納しているディスクが満杯になった場合，a_rdb_RC_SQL_WARNINGが返却されます。

3. クライアントメッセージログファイルにメッセージが出力できない場合にエラーが発生したときは，エラー要因コードが返却されます。エラー要因コードについては，「19.8　CLI関数の戻り値」を参照してください。

ページの先頭へ

(5)　留意事項

1. a_rdb_SQLParameterInfo_t構造体のデータ格納領域の先頭アドレスに対して境界位置調整を行ってください。境界位置調整については，「18.2.6　CLI関数を使用する場合の留意事項」の「(2)　境界位置調整」を参照してください。

2. 次に示す場合，a_rdb_SQLBindParams()は実行できません。

   • コネクションが確立されていない場合

   • 無効な文ハンドルを指定した場合

   • ？パラメタ数に，a_rdb_SQLNumParams()で取得した？パラメタの数以外の値を指定した場合

ページの先頭へ