The PROMOTIC application checks the validity in the list of users and then this event is triggered 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).
|pMe||(Object) Reference to the PmaRoot object where the event rises.|
|pEvent||(Object) Reference to object describing detailed information about the specific event.|
pEvent.User - (Object) The PmUser object that represents the user being logged in.
pEvent.UserId - (String) Identifier of the logged on user. The value 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 is preset to the name entered by the user.
pEvent.Password - (String) Password of the logged on user. The value 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 name or password - is eventually displayed after the event is completed. The value can be changed and modify the displayed warning.
0 - 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 is preset according to the validity comparison of entered data with the list of users. If the value of the property is true, then 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.
if (pEvent.User.Type == 1)
//... The code executed only for local users
var aUsers = Pm.GetUserInfo("what:loguserarray;type:net;");
var nUsers = aUsers.GetSize(1);
for (i = 0; i < nUsers; i++)
if (aUsers.GetItem(i).Id == pEvent.UserId)
pEvent.Enabled = 0;