Function ''LoginUser()''

Logins a user to the current security domain.

Syntax:

LoginUser(username[, password, multiple-login-allowed])

Parameters:

username 

the name of the user to logon

password 

the password for the user

multiple-login-allowed 

Optional parameter. The default is true. Specify false to block the users to login more than one with the same username. If multiple-login is not allowed by setting false to this parameter, the second login with the same user name will throw the current user user out of the system.

Completion Codes:

 0: Normal completion

 8: username not found or disabled or password is incorrect.

12: Syntax error or Security Broker error

Examples:

LoginUser('sa', 'mmsa')

LoginUser('sa', 'mmsa', false)

Suspending An User

If an user enters wrong password more than the times defined in Maximum Tries property of SecurityDomain element, then he is suspended and a pool variable named user_suspended is created and assigned value "true". By controlling this variable custom solutions can be implemented.