WaitForDataSourceメソッド
機能
DBPreparedStatementオブジェクトで要求した実行待ち,及び実行中の非同期処理が終了するまで待ちます。非同期処理中に同期を取りたい場合に利用できます。
形式
BOOLEAN WaitForDataSource(UINT32 swWaitTime = DBR_INFINITE)
引数
swWaitTime
非同期処理の終了を待つための最大時間(単位:ミリ秒),又はDBR_INFINITEを指定します。
指定した時間内に非同期処理が終了した場合,TRUEが返ります。指定した時間を経過しても非同期処理が終了しない場合,FALSEが返ります。非同期実行中のSQLがない場合は,TRUEが返ります。
DBR_INFINITEを指定した場合はタイムアウト時間を設定しません。非同期処理が終了するまで待ち続けます。
同期実行時はすぐにTRUEを返します。
戻り値
データ型:BOOLEAN
TRUE:すべての非同期処理が終了しました。
FALSE:タイムアウト時間が経過しました。
機能詳細
DBPreparedStatementオブジェクトで要求した実行待ち,及び実行中の非同期処理(SQL)が,終了するのを待ちます。
DBConnectionクラスのWaitForDataSourceメソッドとの違い
DBPreparedStatementオブジェクトのWaitForDataSourceメソッドでは,WaitForDataSourceメソッドを実行したDBPreparedStatementオブジェクトの非同期実行処理が終了するまで待ちます。ほかのオブジェクトの非同期実行処理については待ちません。そのため,ほかのオブジェクトの非同期実行処理が実行中でも,WaitForDataSourceメソッドを呼び出したオブジェクトの非同期実行処理が終了すれば,WaitForDataSourceメソッドはTRUEを返します。
同じDBConnectionオブジェクトで実行しているすべての非同期実行処理が終了するのを待ちたい場合は,DBConnectionクラスのWaitForDataSourceメソッドを実行してください。
発生する例外
なし