System.Win.Mtsobj.TMtsAutoObject.SetAbort

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

procedure SetAbort;

C++

void __fastcall SetAbort();

Propriétés

Type Visibilité  Source Unité  Parent
procedure
function
public
System.Win.Mtsobj.pas
System.Win.Mtsobj.hpp
System.Win.Mtsobj TMtsAutoObject

Description

Autorise la désactivation de l'objet automation MTS et l'abandon des transactions en cours.

Appelez la méthode SetAbort pour indiquer l'abandon de toute transaction en cours incluant l'objet automation MTS. Si MTS a démarré une transaction automatiquement, la transaction est abandonnée à la sortie de l'appel de méthode en cours. Si l'objet automation MTS a été engagé dans une transaction préexistante, la transaction client peut échouer. Généralement, SetAbort est appelée dans le bloc except d'une instruction try...except.

Outre l'abandon de toute transaction en cours, SetAbort indique que l'objet automation MTS peut être désactivé à la sortie de l'appel d'interface en cours. Cela signifie que les informations d'état ne sont préservées pour le prochain appel par le client de l'interface de l'objet automation. Pour empêcher la validation réussie des transactions sans perdre les informations d'état, utilisez la méthode DisableCommit.

Conseil :  Appelez SetAbort au début d'une méthode afin d'empêcher le module de données MTS de valider prématurément dans le cas d'une sortie imprévue de la méthode. Si l'appel de méthode se termine normalement, appelez SetComplete pour annuler ce processus et permettre l'achèvement de la transaction.