Compartir a través de

SQLMORERESULTS( ) (Función)

  • Artículo

Copia otro conjunto de resultados a un cursor de Visual FoxPro si hay más conjuntos de resultados disponibles.

SQLMORERESULTS(nConnectionHandle)

Valores devueltos

Numeric

Parámetros

  • nConnectionHandle
    Especifica el identificador de conexión al origen de datos devuelto por SQLCONNECT( ).

Observaciones

SQLMORERESULTS( ) determina si hay más conjuntos de resultados disponibles en una instrucción SQL ejecutada con SQLEXEC( ) en modo no por lotes. Si hay más conjuntos de resultados disponibles, se copiarán a un cursor de Visual FoxPro, un conjunto cada vez.

SQLMORERESULTS( ) devuelve 0 si la instrucción SQL sigue ejecutándose, devuelve 1 si ha acabado de ejecutarse y 2 si no se encuentran más datos. En modo no por lotes, SQLMORERESULTS( ) debería llamarse después de cada llamada con éxito a SQLEXEC( ) hasta que SQLMORERESULTS( ) devuelva 2 (no se encuentran más datos). La configuración de la opción de modo por lotes SQLSETPROP( ) determina si SQLEXEC( ) ejecuta una instrucción SQL en modo por lotes o no por lotes.

SQLMORERESULTS( ) devuelve – 1 si se produce un error de nivel de conexión y – 2, si se produce un error de nivel de entorno.

SQLMORERESULTS( ) es una de las cuatro funciones que se pueden ejecutar en modo síncrono o asíncrono. La configuración asíncrona de SQLSETPROP( ) determina si estas funciones se ejecutan en modo síncrono o asíncrono. En modo asíncrono, deberá llamar a SQLMORERESULTS( ) repetidamente mientras devuelva un valor distinto de 0 (sigue ejecutándose).

Ejemplo

En el ejemplo siguiente se supone que SQLCONNECT( ) se ejecuta correctamente y su valor devuelto se almacena en una variable de memoria llamada gnConnHandle. SQLSETPROP( ) se usa para establecer la propiedad BatchMode en el valor falso (.F.) de forma que se puedan recuperar los conjuntos de resultados individuales.

SQLMORERESULTS( ) se ejecuta por segunda vez para crear dos cursores que contienen los resultados de la consulta SQLEXEC( ). SET se utiliza para mostrar la ventana Vista y los cursores creados por SQLEXEC( ).

= SQLSETPROP(gnConnHandle, 'BatchMode', .F.)  && Individual result sets
= SQLEXEC(gnConnHandle, 'SELECT * FROM authors;
   SELECT * FROM titles')
= SQLMORERES(gnConnHandle)  && First result set
= SQLMORERES(gnConnHandle)  && Second result set

Vea también

AERROR( ) | SQLCANCEL( ) | SQLCONNECT( ) | SQLEXEC( ) | SQLGETPROP( ) | SQLSETPROP( )