SQLCOMMIT( ) (Función)

Artículo
04/11/2008

Confirma una transacción.

SQLCOMMIT(nConnectionHandle)

Valores devueltos

Numeric

Parámetros

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

Observaciones

Utilice SQLCOMMIT( ) para confirmar una transacción. SQLCOMMIT( ) devuelve 1 si se confirma la transacción; en caso contrario, devuelve -1. Si SQLCOMMIT( ) devuelve -1, puede utilizar AERROR( ) para determinar por qué no puede confirmarse la transacción.

Si están vigentes las transacciones manuales (la propiedad SQLSETPROP( ) Transactions está establecida como Manual), puede enviar varias actualizaciones a tablas remotas y confirmar todas las actualizaciones con SQLCOMMIT( ).

Las actualizaciones pueden anularse con SQLROLLBACK( ).

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 Transactions en 2 (Manual), lo que le permite usar SQLCOMMIT( ) y SQLROLLBACK( ).

La tabla authors se modifica con SQLEXEC( ) y los cambios a la tabla se confirman con SQLCOMMIT( ).

= SQLSETPROP(gnConnHandle, 'Transactions', 2)  && Manual transactions
= SQLEXEC(gnConnHandle, "INSERT INTO authors (au_id, au_lname);
   VALUES ('aupoe', 'Poe')")  && Modify the authors table
= SQLCOMMIT(gnConnHandle)  && Commit the changes

Vea también

Share via