Hitachi

Hitachi Advanced Data Binder AP開発ガイド


19.4.1 a_rdb_SQLAllocStmt()(文ハンドルの確保)

〈この項の構成〉

(1) 機能

文ハンドル(SQL文のハンドル)を確保します。

(2) 形式

signed short a_rdb_SQLAllocStmt
(
  void                          *ConnectionHandle,   /* In  */
  void                         **StatementHandle,    /* Out */
  void                          *Option              /* In  */
)

(3) 引数の説明

ConnectionHandle

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

StatementHandle

文ハンドルを設定するアドレスを指定します。

Option

NULLを指定します。

(4) 戻り値

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

  2. 文ハンドルの確保には成功したが,サーバメッセージログファイルまたはクライアントメッセージログファイルを格納しているディスクが満杯になった場合,a_rdb_RC_SQL_WARNINGが返却されます。

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

(5) 留意事項

  1. コネクションが確立されていない場合,a_rdb_SQLAllocStmt()は実行できません。

  2. トランザクションの開始に失敗した場合,HADBサーバは異常終了します。