Lets the user log onto the current application.
You can use this function if you need to switch users automatically without closing the application and reopen it again.
|
Syntax:
|
Logon (user name, password)
|
Parameters:
|
User name (alpha) - parameter specifying the user name. Password (alpha) - parameter specifying the password.
|
Returns:
|
Logical indicating success or failure of the operation.
|
Example:
|
Logon ('CARL','PASS321') performs similarly to the User Logon. Unlike the User logon, Logon processes the user name and password in a batch mode.
|
Note:
|
-
When binding to an LDAP server (System Logon = LDAP), instead of using the Logon function, you can choose to define two secret names, LDAP_USER and LDAP_PASS, for the user name and password. The $USER$ alias in the connection string will be substituted with the value of the LDAP_USER secret name. For more information, see the LDAP Address, LDAP Connection String environment settings.
-
When evaluating the Logon function from a Browser Client or Rich Client task, the User ID details are saved to the context. You can use the RqContexts function to return the User ID. Any context opened from this context will also automatically get the User ID.
|
See also:
|
The Online and Rich Client Samples projects (program SE04 and RSE04)
|