Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 (Deutsch) » UltraLite - C- und C++-Programmierung » API-Referenz » UltraLite C++-API-Referenz » UltraLite_DatabaseManager_iface-Klasse

 

OpenConnection-Funktion

Öffnet eine neue Verbindung zu einer vorhandenen Datenbank.

Syntax
UltraLite_Connection * UltraLite_DatabaseManager_iface::OpenConnection(
  ULSqlcaBase & sqlca,
  ULValue const & parms_string
)
Parameter
  • sqlca   Der initialisierte sqlca zum Zuordnen zu der neuen Verbindung

  • parms_string   Die Verbindungszeichenfolge

Bemerkungen

Der angegebene sqlca ist der neuen Verbindung zugeordnet.

  • SQLE_CONNECTION_ALREADY_EXISTS - Eine Verbindung mit dem angegebenen SQLCA-Bereich und Namen (oder ohne Namen) ist bereits vorhanden. Sie müssen erst die bestehende Verbindung trennen oder einen anderen Verbindungsnamen mit dem CON-Parameter angeben, bevor Sie eine Verbindung herstellen können.

  • SQLE_INVALID_LOGON - Sie haben eine ungültige Benutzer-ID oder ein falsches Kennwort eingegeben.

  • SQLE_INVALID_SQL_IDENTIFIER - Es wurde ein ungültiger Bezeichner über die Schnittstelle für die Sprache C angegeben. Beispiel: Sie haben vielleicht eine NULL-Zeichenfolge für einen Cursornamen angegeben.

  • SQLE_TOO_MANY_CONNECTIONS - Die Anzahl der parallelen Datenbankverbindungen wurde überschritten.

Um Fehlerinformationen abzurufen, verwenden Sie die zugeordnete ULSqlca-Klasse. Zu den möglichen Fehlern gehören:

Rückgabe
  • Wenn die Funktion erfolgreich ist, wird ein neues Verbindungsobjekt zurückgegeben.

  • Wenn die Funktion fehlschlägt, wird NULL zurückgegeben.