SQLCOMMIT( )-Funktion

Übergibt eine Transaktion.

SQLCOMMIT(nConnectionHandle)

Rückgabewerte

Numerisch

Parameter

• nConnectionHandle
  Gibt das Verbindungshandle der Datenquelle an, das von SQLCONNECT( ) zurückgegeben wird.

Hinweise

Verwenden Sie SQLCOMMIT( ) zum Übergeben einer Transaktion. SQLCOMMIT( ) gibt 1 zurück, wenn die Transaktion erfolgreich übergeben wurde. Andernfalls wird -1 zurückgegeben. In diesem Fall können Sie mit AERROR( ) ermitteln, warum die Transaktion nicht übergeben werden konnte.

Wenn manuelle Transaktionen aktiv sind (die Transactions-Eigenschaft von SQLSETPROP( ) ist auf Manual eingestellt), können Sie mehrere Aktualisierungsvorgänge an Remotetabellen senden und alle Aktualisierungsvorgänge mit SQLCOMMIT( ) übergeben.

Aktualisierungen können mit SQLROLLBACK( ) zurückgesetzt werden.

Beispiel

Im folgenden Beispiel wird davon ausgegangen, dass SQLCONNECT( ) erfolgreich ausgeführt und der entsprechende Rückgabewert in der Speichervariablen gnConnHandle gespeichert wird. Die Transactions-Eigenschaft wird mit SQLSETPROP auf 2 (Manual) gesetzt. Dann können Sie SQLCOMMIT( ) und SQLROLLBACK( ) verwenden.

Die Tabelle authors wird mit Hilfe von SQLEXEC( ) geändert. Die Änderungen werden mit SQLCOMMIT( ) übergeben.

= 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

Siehe auch

AERROR( ) | BEGIN TRANSACTION | END TRANSACTION | SQLCONNECT( ) | SQLROLLBACK( ) | SQLSETPROP( )