Transact

Transact_ReleaseFile
(SWI &4FC0B)

Typiquement, après qu'un fichier de données RISC OS ait été ouvert par le moteur Transact, il reste ouvert jusqu'à ce que le moteur soit "tué" d'une façon ou d'une autre. Cela signifie que si vous double-cliquez sur l'icône fichier dans une fenêter Filer, le résultat d'une telle action est le message suivant "<filename> is currently open". Cependant, à quelques occasions, il peut être utile de laisser d'autres applications (spécialement celles non conçues pour s'interfacer avec le module Transact) appliquer leurs propres changements au fichier de données. C'est la raison d'être de ce SWI.
Il existe quelque prérequis et effets de bord liés à son utilisation dont le développeur doit tenir compte:

1. En dehors de la session initiant ce SWI, aucune autre session ne doit avoir une transaction active sur le fichier de données à libérer, sinon une erreur "Conflict with another session" est retournée.
2. Ce SWI effectue un rollback implicite au nom de la session courante: le programmeur doit alors s'assurer que aucune écriture ne soit "pendante" sur le fichier à libérer.

En entrée

• R0 = ID externe de session telque retouné par Transact_CreateSession;
• R1 = ID externe de fichier (NULL ou pointeur sur nom de fichier);
• R2 = Pointeur sur l'ID interne du fichier à accéder;

En sortie

• Tous les registes sont conservés.

Erreurs possibles

• &812B00 Busy (non implémenté dans cette release)
• &812B01 Unknown session
• &812B07 Conflict with another session which already has an active transaction on the file to release