DBLogDlg.LoginDialogEx Function

Brings up the database Login dialog to allow the user to connect to a database server.

Pascal

function LoginDialogEx(const ADatabaseName: string; var AUserName: string; var APassword: string; NameReadOnly: Boolean): Boolean;

C++

Boolean LoginDialogEx(const AnsiString ADatabaseName, AnsiString AUserName, AnsiString APassword, Boolean NameReadOnly);

File

DBLogDlg

Description

Call LoginDialogEx to bring up the standard Login dialog box to prompt the user for a valid user name and password. The ADatabaseName parameter specifies the database for which access is being requested. The NameReadOnly parameter specifies whether the user can change the user name from within the dialog.

The dialog returns the user name and password as the AUserName and APassword parameters.

LoginDialogEx returns falseif the user cancels out of the dialog. If LoginDialogEx returns true, the application can attempt to connect to the database server using the supplied user name and password.

Note: When building cross-platform applications in C++, add QDBLogDlg.pas unit (instead of DBLogDlg) to your project if you want the default Database Login dialog to display at runtime. QDBLogDlg does not need to be included if your C++ application includes a DBGrid component.