int db_cancel_request( SQLCA * sqlca );

キャンセル要求が送信された場合は 1、要求が送信されなかった場合は 0 を返します。

現在アクティブなデータベースサーバ要求をキャンセルします。この関数は、キャンセル要求を送信する前に、データベースサーバ要求がアクティブかどうかを調べます。

戻り値が 0 でないことが、要求がキャンセルされたことを意味するわけではありません。キャンセル要求とデータベースまたはサーバからの応答が行き違いになるようなタイミング上の危険性はほとんどありません。このような場合は、関数が TRUE を返しても、キャンセルは効力を持ちません。

db_cancel_request 関数は非同期で呼び出すことができます。別の要求が使用している可能性のある SQLCA を使用して非同期で呼び出すことができるのは、データベースインタフェースライブラリではこの関数と db_is_working だけです。

カーソル操作実行要求をキャンセルした場合は、カーソルの位置は確定されません。キャンセルしたあとは、カーソルを絶対位置に位置付けるか、閉じます。

• SQLCA (SQL Communication Area)