Executeメソッド

機能

引数で指定したSQL文の情報をデータベースに通知します。

SELECT文によって検索結果を取得する場合,Executeメソッドを呼び出した後,GetResultSetメソッドを呼び出してDBResultSetオブジェクトを生成します。

形式

void Execute (LPCTSTR lpctStatement,
             UINT16 swWait = LOCK_OPT_DEFAULT)      throw DBSQLCA

引数

lpctStatement

SQL文を指定します。

swWait

実行するSQL単位に,検索対象のレコードがほかのトランザクションによってロックされていた場合の動作を指定します。

SQL/Kの場合は,どの値を指定しても,ロックが解除されるまで待ち状態になります。

XDM/SDの場合は,どの値を指定しても,ロックが解除されるまで待たないで,すぐにエラーを返します。

次の値のうち,どれか一つを指定します。

戻り値

なし

機能詳細

引数lpctStatementで指定されたSQL文の情報をデータベースに通知します。また,そのSQL文ごとに排他エラーの処理形態を変更できます。

このメソッドは,非同期実行可能なメソッドです。(SELECT文以外の実行時)

発生する例外

DBSQLCA(RetCode)

DB_ERROR_NOT_ENOUGH_MEMORY
メモリ容量が不足しています。
DB_ERROR_IN_ASYNC_EXECUTE
ステートメントが非同期実行処理中です。
DB_ERROR_DRIVER_ERROR
DBMSでエラーが発生しました。
DB_ERROR_DAB_ACCESS_ERROR
DABrokerでエラーが発生しました。
DBSQLCAクラスで詳細コードを確認してください。
DB_ERROR_DAB_SYSTEMCALL_ERROR
システムコールでエラーが発生しました。
DBSQLCAクラスで詳細コードを確認してください。
DB_ERROR_TIMEOUT
タイムアウトが発生したため制御を戻します。
DB_DRV_ERROR_INVALID_SQL_EXCLUSIVE
WITH句で始まるSQL文の指定時には,DBResultSetオブジェクトの生成オプションをTYPE_EXCLUSIVE以外に設定してください。