Opens a new connection to an existing database.
public static ULConnection * OpenConnection( const char * connParms, ULError * error, void * reserved )
connParms The connection string.
error An optional ULError object to return error information.
reserved Reserved for internal use.
A new ULConnection if the function succeeds. NULL is returned if the function fails.
To get error information, pass in a pointer to a ULError object. The following is a list of possible errors:
SQLE_INVALID_PARSE_PARAMETER connParms was not formatted properly.
SQLE_UNRECOGNIZED_OPTION A connection option name was likely misspelled.
SQLE_INVALID_OPTION_VALUE A connection option value was not specified properly.
SQLE_ULTRALITE_DATABASE_NOT_FOUND The specified database could not be found.
SQLE_INVALID_LOGON You supplied an invalid user ID or an incorrect password.
SQLE_TOO_MANY_CONNECTIONS You exceeded the maximum number of concurrent database connections.
For more information about UltraLite connection parameters, see UltraLite connection parameters.