SQLCANCEL() 函 数

请求取消一条正在执行的 SQL 语句

语 法

SQLCANCEL( nConnectionHandle )

返 值 类 型数值型 参 数 描 述

nConnectionHandle

指 定 活 动 的 连 接 句 柄 该 连 接 句 柄 的 SQL 语 句 将 被 取 消

说 明

如果成功取消了 SQL 语句 SQLCANCEL ( ) 函数返回 1 如果发生连接级错误 返回

-1 如果发生环境级错误 返 回 -2

在异步方式下 SQLCANCEL ( ) 取消执行 SQLCOLUMNS( ) SQLEXEC( ) SQLMORERESULTS( ) 和 SQLTABLES( ) 命令 可使用 SQLSETPROP( ) 来建立异步

方式

示 例

下面的示例假定已经成功发出 SQLCONNEC T( ) 并且返回值存入名为 gnConnHandle

的变量

SQLEXEC ( ) 将 SQL 语句送入数据源 并且将返回结果送入临时表 最后调用

SQLCANCEL( ) 函数来终止查询

= SQLSETPROP(gnConnHandle, 'asynchronous', .T.) && 停止 SQLEXEC( )

= SQLEXEC(gnConnHandle, 'SELECT * FROM authors')

= SQLCANCEL(gnConnHandle) && 错误的 SELECT 语句 取消

请 参 阅