Compartir a través de

SQLCANCEL( ) (Función)

  • Artículo

Solicita la cancelación de una instrucción SQL que se está ejecutando.

SQLCANCEL(nConnectionHandle)

Valores devueltos

Numeric

Parámetros

  • nConnectionHandle
    Especifica el identificador de conexión activo cuya instrucción SQL se va a cancelar.

Observaciones

SQLCANCEL( ) devuelve 1 si la instrucción SQL se cancela satisfactoriamente, – 1 si hay un error de nivel de conexión y – 2 si hay un error de nivel de entorno.

SQLCANCEL( ) cancela la ejecución de SQLCOLUMNS( ), SQLEXEC( ), SQLMORERESULTS( ) y SQLTABLES( ) en modo asíncrono. Utilice SQLSETPROP( ) para establecer el modo asíncrono.

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.

SQLEXEC( ) se usa para enviar una instrucción SQL al origen de datos y devolver el resultado a un cursor. SQLCANCEL( ) se ejecuta para detener la consulta.

= SQLSETPROP(gnConnHandle, 'asynchronous', .T.)  && To stop SQLEXEC( )
= SQLEXEC(gnConnHandle, 'SELECT * FROM authors')
= SQLCANCEL(gnConnHandle)  && Wrong select statement, cancel

Vea también

AERROR( ) | SQLCOLUMNS( ) | SQLEXEC( ) | SQLMORERESULTS( ) | SQLSETPROP( ) | SQLTABLES( )