SQLConnect function

Connects to a database, for UltraLite ODBC.

Syntax
UL_FN_SPEC SQLRETURN UL_FN_MOD SQLConnect (
SQLHDBC ConnectionHandle,
SQLTCHAR * ServerName,
SQLSMALLINT NameLength1,
SQLTCHAR * UserName,
SQLSMALLINT NameLength2,
SQLTCHAR * Authentication,
SQLSMALLINT NameLength3 );
Parameters
  • ConnectionHandle   The connection handle.

  • ServerName   A connection string that defines the database to which your application connects. UltraLite ODBC does not use ODBC data sources. Instead, supply a connection string containing the database connection parameters, together with optional other parameters.

    The following is an example of a ServerName parameter:

    (SQLTCHAR*)UL_TEXT( 
        "dbf=customer.udb" 
    )

    For a complete list of connection parameters, see UltraLite connection parameters.

  • NameLength1   The length of *ServerName.

  • UserName   The user ID to use when connecting. The user ID can alternatively be specified in the connection string supplied to the ServerName parameter.

  • NameLength2   The length of *UserName.

  • Authentication   The password to use when connecting. The password can alternatively be specified in the connection string supplied to the ServerName parameter.

  • NameLength3   The length of *Authentication.

Remarks

Connects to a database. For more information about UltraLite connection parameters, see UltraLite connection parameters.