OdbcConnect

obj -> OdbcConnect(alpha1[, alpha2[, alpha3]]) : handle

Verbindung zu einer Datenquelle herstellen

Details

• obj: Deskriptor der ODBC-Schnittstelle
• alpha1: Name der Datenquelle
• alpha2: Benutzer (optional)
• alpha3: Kennwort (optional)
• Resultat: handle Deskriptor des Verbindungsobjekts
• Siehe: Verwandte Befehle , OdbcOpen () , OdbcConnectDriver () , OdbcClose ()

Mit dieser Anweisung wird eine Verbindung zu einer Datenquelle hergestellt. Als (obj) wird ein Deskriptor auf ein gültiges OdbcApi -Objekt übergeben (siehe OdbcOpen ()). Der Name der Datenquelle wird in (alpha1) übergeben. Die vorhandenen Datenquellen können zuvor mit der Anweisung OdbcDataSources () ermittelt werden.

Ist eine Benutzeranmeldung notwendig, muss in (alpha2) und (alpha3) der Benutzer und das Kennwort angegeben werden.

Bei erfolgreicher Durchführung liefert der Befehl einen Deskriptor auf ein OdbcCon -Objekt zurück. Dieser Deskriptor kann zum Aufruf weiterer Befehle verwendet werden:

• OdbcCatalogTbl ()
• OdbcCatalogClm ()
• OdbcExecuteDirect ()
• OdbcPrepare ()
• OdbcClose ()

Die Verbindung zur Datenquelle wird mit der Anweisung OdbcClose () wieder getrennt.

Es können Verbindungen zu mehreren Datenquellen gleichzeitig aufgebaut werden.

Konnte keine Verbindung zu der angegebenen Datenquelle aufgebaut werden, gibt die Anweisung den Fehlerwert _ErrOdbcError zurück. Genauere Informationen über den Fehler können über die OdbcErr...-Eigenschaften des OdbcApi -Objekts abgefragt werden. Ist schon die Erstellung des ODBC-Verbindungs-Objekts fehlgeschlagen, gibt die Anweisung _ErrOdbcFunctionFailed zurück.

Mögliche Laufzeitfehler:

• _ErrHdlInvalid: Der in (obj) übergeben Deskriptor ist kein Deskriptor auf ein gültiges OdbcApi -Objekt.