SQLDISCONNECT( )-Funktion
Beendet eine Verbindung zu einer Datenquelle.
SQLDISCONNECT(nConnectionHandle)
Rückgabewerte
Numerisch
Parameter
- nConnectionHandle
Gibt das Verbindungshandle der Datenquelle an, das von SQLCONNECT( ) zurückgegeben wurde. Geben Sie 0 für nConnectionHandle an, um alle aktiven Verbindungen zu beenden.
Hinweise
SQLDISCONNECT( ) gibt folgende Werte zurück: 1, wenn die Verbindung erfolgreich beendet wurde; -1, wenn ein Fehler auf Verbindungsebene aufgetreten ist, und -2, wenn ein Fehler auf Umgebungsebene aufgetreten ist.
SQLDISCONNECT( ) Beendet eine Verbindung zu einer Datenquelle. Sie müssen das Verbindungshandle angeben, das SQLCONNECT( ) beim Herstellen der Verbindung zurückgegeben hat.
Anmerkung Wenn Sie SQLDISCONNECT( ) innerhalb einer asynchronen Funktionsfolge oder während einer Transaktion ausführen, erzeugt SQLDISCONNECT( ) einen Fehler.
Beispiel
Das folgende Beispiel setzt die Existenz einer ODBC-Datenquelle namens MyFoxSQLNT voraus, die mit dem Benutzernamen "sa" angesprochen werden kann. SQLCONNECT( ) wird eingegeben, und der entsprechende Rückgabewert in der Speichervariablen gnConnHandle gespeichert.
Wenn die Verbindung zu der Datenquelle erfolgreich hergestellt wurde, gibt SQLCONNECT( ) eine positive Zahl zurück. Ein Dialogfeld wird angezeigt, und die Verbindung zur Datenquelle wird mit SQLDISCONNECT( ) wieder aufgehoben.
Wenn keine Verbindung zur Datenquelle hergestellt werden kann, gibt SQLCONNECT( ) eine negative Zahl zurück, und eine Fehlermeldung wird angezeigt.
STORE SQLCONNECT('MyFoxSQLNT', 'sa') TO gnConnHandle
IF gnConnHandle <= 0
= MESSAGEBOX('Cannot make connection', 16, 'SQL Connect Error')
ELSE
= MESSAGEBOX('Connection made', 48, 'SQL Connect Message)
= SQLDISCONNECT(gnConnHandle)
ENDIF