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

Siehe auch

AERROR( ) | SQLCONNECT( ) | SQLSTRINGCONNECT( )