OpenConnection method

Opens a new connection to an existing database.

Syntax

public static ULConnection * OpenConnection(
    const char * connParms,
    ULError * error,
    void * reserved
)

Parameters

connParms The connection string.
error An optional ULError object to return error information.
reserved Reserved for internal use. Omit or set to null.

The connection string is a set of option=value connection parameters (semicolon separated) that indicates which database to connect to, and options to use for the connection. For example, after securely obtaining your encryption passphrase, the resulting connection string might be: "DBF=mydb.udb;DBKEY=iyntTZld9OEa#&G".

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.

OpenConnection method

Syntax

Parameters

Returns

Remarks

See also