The Login_OpenDexDialog() function allows the user to log into the named data source using Dexterity’s predefined Login window.
Login_OpenDexDialog()
• None
An integer corresponding to one of the following constants:
![[spacer]](1p.gif){kind=small}
|
Constant |
Description |
|---|---|
|
STATUS_SUCCESS |
The login was successful. |
|
STATUS_ERROR |
An unknown error occurred. |
|
STATUS_ALREADY_LOGGED_IN |
That user is already logged in. |
|
STATUS_LOGIN_FAILED |
The login information was invalid. |
|
STATUS_CANCEL |
The user pressed the Cancel button. |
|
STATUS_TOO_MANY_CONNECTIONS |
The maximum number of connections to the database was reached. |
|
STATUS_DATASOURCE_REJ |
The server acknowledged the connection attempt, but rejected it. The problem was server-based. |
|
STATUS_UNABLE_TO_CONNECT |
The client computer’s ODBC drivers were unable to establish a connection to the server. The problem was client-based. |
This function opens a predefined Login window that prompts the user for a data source, user ID and password. To use a login window you’ve created, use the Login_LogIntoDataSource() function.
If the SQLDataSource and SQLUser default settings are included in the defaults file for the current client, those values will be displayed in the Data Source and User_ID fields, and the user will be prompted for a password. If the SQLPassword setting is also included in the defaults file, then the Login window will be bypassed and the connection will be attempted automatically.
|
To assure your application’s security and data integrity, we recommend that you don’t use the SQLPassword defaults file setting. |
If the SQLDataSource and SQLUser settings aren’t included in the defaults file, the values displayed in the Data Source and User_ID fields of the Login window will be the values currently in the SQLLastDataSource and SQLLastUser settings of the defaults file, which are generated automatically by Dexterity.