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

SQLConnect function

Connects to a database, for UltraLite ODBC.

UL_FN_SPEC SQLRETURN UL_FN_MOD SQLConnect (
SQLHDBC ConnectionHandle,
SQLTCHAR * ServerName,
SQLSMALLINT NameLength1,
SQLTCHAR * UserName,
SQLSMALLINT NameLength2,
SQLTCHAR * Authentication,
SQLSMALLINT NameLength3 );

• 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 String Parameters Reference.

• 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.

Connects to a database. For more information about UltraLite connection parameters, see UltraLite Connection String Parameters Reference.

•  SQLConnect in the Microsoft ODBC Programmer's Reference.