Compartir a través de


SQLROLLBACK( ) (Función)

Cancela los cambios realizados durante la transacción actual.

SQLROLLBACK(nConnectionHandle)

Valores devueltos

Numeric

Parámetros

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

Observaciones

SQLROLLBACK( ) devuelve 1 si la transacción se deshace; en caso contrario, devuelve -1. Si SQLROLLBACK( ) devuelve -1, puede utilizar AERROR( ) para determinar porqué no fue posible deshacer la transacción.

Si están vigentes las transacciones manuales (la propiedad de la transacción SQLSETPROP( ) está establecida como Manual), puede enviar varias actualizaciones a tablas remotas. Las actualizaciones se pueden deshacer con SQLROLLBACK( ).

Las actualizaciones se pueden confirmar con SQLCOMMIT( ).

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 utiliza para establecer la propiedad Transactions a 2 (Manual), lo que le permite usar SQLCOMMIT( ) y SQLROLLBACK( ).

La tabla authors se modifica con SQLEXEC( ) y los cambios realizados a la tabla se cancelan con SQLROLLBACK( ).

= SQLSETPROP(gnConnHandle, 'Transactions', 2)  && manual
= SQLEXEC(gnConnHandle, "INSERT INTO authors (au_id, au_lname);
   VALUES ('aupoe', 'Poe')")
= SQLROLLBACK(gnConnHandle)

Vea también

AERROR( ) | SQLCOMMIT( ) | SQLCONNECT( ) | SQLSETPROP( )