Promotic
WikipediaLinkedInYoutubeTwitterFacebook

onUserLogonBegin - event of object PmRoot

Description:
The event fires on an attempt to log in the user into the running application after the user entered the login name and password. The PROMOTIC checks the validity in the list of users and then invokes the event with parameters in the pEvent object preset according to the fact if the name and password have been found in the list or not. By this way it is possible to enable or disable the log-on of the user even according to other criteria than are covered in the standard log-on processing. So it is possible, for example, to create self-lists of users saved in the INI file with encrypted passwords (Pm.IniFileRead, Pm.IniFileWrite, Pm.EncryptText and Pm.DecryptText).
Parameters:
pMe(Object) Reference to the Promotic object where the event rises.
pEvent(Object) A referrence to object describing detailed information about the specific event.
pEvent.User - (Object) User object represents the user being logged in.
pEvent.UserId - (String) Identifier of the logged on user. The value of the parameter is preset if the login name entered by user is found in the list of users.
pEvent.Name - (String) Name of the logged on user. The value of this parameter is preset to the name entered by the user.
pEvent.Password - (String) Password of the logged on user. The value of this parameter is preset to the password entered by the user.
pEvent.Error - (Long) Specifies which information is not correct. According to the current value a warning - invalid user or invalid password - is eventually displayed after the event is completed. This value can be changed and modify the displayed warning.
0 - Both user name and password are valid.
1 - User name is not valid.
2 - Password is not valid.
pEvent.Enabled - (Boolean) Enable/disable the log-on of the user. The value of the parameter is preset according to the validity comparison of entered data with the list of users. If the value of the property is true, the log-on of the user is enabled. Otherwise the value of the property is false. By this way it is possible, for example, to enable (disable) the log-on of the user from the list of users who in normal circumstances couldn't (could) be logged on.
pEvent.Level - (Integer) (obsolete) The level of the user. The value of the parameter is preset according to the validity comparison of entered data with the list of users. The level of the logged on user can be entered or changed by this way (needn't be set from the list of users).
Note:
The event is called for every user (both local and network). Deatiled user information (User object) are avilable in the pEvent.User parameter.
Example1:
If needed to execute some code only for local users, then it is possible to test the values of the User.Type property.
If pEvent.User.Type = 1
   ... The code executed only for local users
End If
Example2:
Refusal of new network user login if user with the same Id is already logged in.
Dim aUsers, oUser
aUsers = Pm.GetUserInfo("what:loguserarray;type:net;")
For Each oUser In aUsers
  If oUser.Id = pEvent.UserId Then
    pEvent.Enabled = 0
  End If
Next
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice