System.Win.Mtsobj.TMtsAutoObject.DisableCommit

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure DisableCommit;

C++

void __fastcall DisableCommit();

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
System.Win.Mtsobj.pas
System.Win.Mtsobj.hpp
System.Win.Mtsobj TMtsAutoObject

Beschreibung

Verhindert, das Clients Transaktionen abschließen.

Durch einen Aufruf von DisableCommit wird festgelegt, dass das MTS-Automatisierungsobjekt die aktuelle Transaktion erst dann abschließen oder Statusinformationen erst dann freigeben kann, wenn ein entsprechender Methodenaufruf durch den Client erfolgt. Nach dem Aufruf von DisableCommit kann die aktuelle Transaktion (falls vorhanden) nur über einen Aufruf von EnableCommit oder SetComplete durch das MTS-Automatisierungsobjekt abgeschlossen werden.

Für Transaktionen, die beim Aufruf der Schnittstelle des MTS-Automatisierungsobjekts automatisch gestartet werden, ist kein Aufruf von DisableCommit erforderlich. Diese Transaktionen werden erst eingetragen, wenn das MTS-Automatisierungsobjekt die Methode SetComplete aufruft. Wenn das MTS-Automatisierungsobjekt jedoch in einer Transaktion verwendet wird, die bereits vorher gestartet wurde, erfolgt die Steuerung der Transaktion durch den Client. Dieser kann versuchen, die Transaktion einzutragen, bevor das MTS-Automatisierungsobjekt seinen Teil der Transaktion abgeschlossen hat. Durch einen Aufruf von DisableCommit kann verhindert werden, dass der Client die Transaktion vorzeitig einträgt. Sollte der Client nach dem Aufruf von DisableCommit versuchen, die Transaktion abzuschließen, wird diese abgebrochen.

Tip:  Durch einen Aufruf von DisableCommit am Beginn einer Methode können Sie verhindern, dass im Fall einer unerwarteten Rückkehr das MTS-Automatisierungsobjekt ein vorzeitiges Eintragen vornimmt. Wenn der Methodenaufruf normal abgeschlossen wird, kann die Wirkung von DisableCommit durch einen Aufruf von EnableCommit oder SetComplete aufgehoben und das Abschließen der Transaktion zugelassen werden.

Siehe auch