SQLRollback()

La fonction SQLRollback() annule ou invalide l'exécution du jeu de transactions le plus récent. Un jeu de transactions est un groupe de commandes émises entre deux fonctions SQLTransact() et SQLCommit().

Un tel ensemble est traité de la même manière qu'une transaction unique. Après l'exécution de la fonction SQLTransact() les opérations effectuées ne sont pas encore validées dans la base de données. Les modifications dans la requête n'interviennent qu'après l'exécution de la fonction SQLCommit(). La fonction SQLRollback() annule le dernier jeu de transactions avant que la fonction SQLCommit() ne soit exécutée.

Catégorie

SQL

Syntaxe

[ResultCode=]SQLRollback(ConnectionID)

Argument

ConnectionID

Nom d'une variable mémoire de type entier, renseignée avec le numéro d'identifiant attribué par la fonction SQLConnect() à chaque connexion avec la base de données.

Exemple

Cet exemple annule la validation dans la base de données et restitue les valeurs antérieures à l'appel de la fonction SQLTransact dans le script.

ResultCode =SQLTransact(ConnectionID);

ResultCode = SQLInsertPrepare(ConnectionID, TableName, BindList, StatementID);

ResultCode = SQLInsertExecute(ConnectionID, BindList, StatementID);

ResultCode = SQLInsertEnd(ConnectionID, StatementID);

ResultCode =SQLRollback(ConnectionID);

Voir aussi

SQLCommit(), SQLTransact()