sqlmoreresults( ) 函数

示例 请参阅

如果存在多个结果集合,则将另一个结果集合复制到 Visual FoxPro 临时表中。

语法

SQLMORERESULTS(nConnectionHandle)

参数
nConnectionHandle

由 SQLCONNECT( ) 返回的、指向数据源的连接句柄。

返回值类型

数值型

说明

在非批处理方式下,SQLMORERESULTS( ) 决定 SQLEXEC( ) 执行语句是否产生多个可用的结果集合。如果有多个结果集合可用,将依次将集合复制到 Visual FoxPro 临时表中。
如果仍在执行 SQL 语句,SQLMORERESULTS( ) 返回 0;如果终止执行 SQL 语句,返回 1;如果没有找到更多数据,返回 2。在非批处理方式下,应该在每次成功调用 SQLEXEC( ) 之后调用 SQLMORERESULTS( ),直到 SQLMORERESULTS( ) 返回 2 (没有找到更多的数据)。SQLSETPROP( ) 批处理设置决定 SQLEXEC( ) 以批处理方式或以非批处理方式执行 SQL 语句。

如果发生连接级的错误,SQLMORERESULTS( ) 返回 -1;如果发生环境级的错误,返回 -2。
sqlmoreresults( ) 函数是既可同步执行也可异步执行的四个函数之一,SQLSETPROP( ) 的异步设置决定这些函数以同步方式执行还是以异步方式执行。在异步方式下,必须重复调用 SQLMORERESULTS( ),直到返回一个非零值 (0 表示仍在执行中)。