OpenConnection function

Synopsis 
UltraLite_Connection * UltraLite_DatabaseManager_iface::OpenConnection(
  ULSqlcaBase & sqlca,
  ULValue const & parms_string
)
Parameters

  • sqlca   The initialized sqlca to associate with the new connection.

  • parms_string   The connection string.

Remarks

Opens a new connection to an existing database.

The given sqlca is associated with the new connection.

  • SQLE_CONNECTION_ALREADY_EXISTS - A connection with the given SQLCA and name (or no name) already exists. Before connecting you must disconnect the existing connection, or specify a different connection name with the CON parameter.
  • SQLE_INVALID_LOGON - You supplied an invalid user ID or an incorrect password.
  • SQLE_INVALID_SQL_IDENTIFIER - An invalid identifier was supplied through the C language interface. For example, you may have supplied a NULL string for a cursor name.
  • SQLE_TOO_MANY_CONNECTIONS - You exceeded the number of concurrent database connections.

To get error information, use the associated ULSqlca class object. Possible errors include:

Returns
  • If the function succeeds, a new connection object is returned.
  • If the function fails, NULL is returned.
Copyright © 2008, iAnywhere Solutions, Inc. - SQL Anywhere 11.0.0