SQLCANCEL( )-Funktion

Gibt die Anforderung für die Unterbrechung einer SQL-Anweisung aus, die momentan ausgeführt wird.

SQLCANCEL(nConnectionHandle)

Rückgabewerte

Numerisch

Parameter

• nConnectionHandle
  Gibt das aktive Verbindungshandle an, dessen SQL-Anweisung unterbrochen werden soll.

Hinweise

SQLCANCEL( ) gibt folgende Werte zurück: 1, wenn die SQL-Anweisung erfolgreich unterbrochen wurde; -1, wenn ein Fehler auf Verbindungsebene aufgetreten ist, und -2, wenn ein Umgebungsfehler aufgetreten ist.

SQLCANCEL( ) bricht die Ausführung von SQLCOLUMNS( ), SQLEXEC( ), SQLMORERESULTS( ) und SQLTABLES( ) im Asynchronmodus ab. Sie können den Asynchronmodus mit SQLSETPROP( ) aktivieren.

Beispiel

Im folgenden Beispiel wird davon ausgegangen, dass SQLCONNECT( ) erfolgreich ausgeführt und der entsprechende Rückgabewert in der Speichervariablen gnConnHandle gespeichert wird.

Mit SQLEXEC( ) wird eine SQL-Anweisung an die Datenquelle geleitet und die Ergebnisse an einen Cursor zurückgegeben. SQLCANCEL( ) wird ausgegeben, um die Abfrage anzuhalten.

= SQLSETPROP(gnConnHandle, 'asynchronous', .T.)  && To stop SQLEXEC( )
= SQLEXEC(gnConnHandle, 'SELECT * FROM authors')
= SQLCANCEL(gnConnHandle)  && Wrong select statement, cancel

Siehe auch

AERROR( ) | SQLCOLUMNS( ) | SQLEXEC( ) | SQLMORERESULTS( ) | SQLSETPROP( ) | SQLTABLES( )