Freigeben über

SQLCONNECT( )-Funktion

  • Artikel

Stellt eine Verbindung zu einer Datenquelle her.

SQLCONNECT([DataSourceName, cUserID, cPassword | cConnectionName])

Rückgabewerte

Numerisch

Parameter

  • DataSourceName
    Gibt den Namen einer Datenquelle an, wie er in der Datei Odbc.ini definiert ist.
  • cUserID
    Gibt eine Benutzer-ID an, mit der Sie sich bei der Datenquelle anmelden.
  • cPassword
    Gibt das Kennwort für die Datenquelle an.
  • cConnectionName
    Gibt den Namen einer Verbindung an, die mit CREATE CONNECTION erstellt wurde.

Hinweise

SQLCONNECT( ) gibt ein positives numerisches Handle ungleich 0 zurück, wenn die Verbindung zur Datenquelle erfolgreich hergestellt wurde. Sie sollten dieses Handle in einer Speichervariablen ablegen und diese Variable bei späteren Funktionsaufrufen, die eine Verbindungs-ID benötigen, wieder verwenden. SQLCONNECT( ) gibt -2 zurück, wenn die Verbindung nicht hergestellt werden kann.

Wenn Sie SQLCONNECT( ) ohne Angabe irgendwelcher zusätzlicher Argumente eingeben, kann das Dialogfeld Verbindung oder Datenquelle auswählen angezeigt werden. Über dieses Dialogfeld können Sie eine Datenquelle auswählen.

Anmerkung   Der ODBC-Logindialog muss deaktiviert sein, damit SQL-Pass-Through durch den Microsoft Transaction Server unterstützt wird. Verwenden Sie SQLSETPROP(cConnectionHandle, 'DispLogin', 3), um den ODBC-Logindialog zu deaktivieren (cConnectionHandle ist das Verbindungshandle, das von SQLCONNECT zurückgegeben wird). Der ODBC-Logindialog kann auch im Verbindungs-Designer deaktiviert werden.

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( ) | CREATE CONNECTION | SQLDISCONNECT( ) | SQLGETPROP( ) | SQLEXEC( ) | SQLSETPROP( ) | SQLSTRINGCONNECT( )