UserPassword()

Update a User's security information.

Public Function UserPassword(ByVal SessionID As String, _
                             ByVal UserID As Integer, _
                             ByVal CurrentRecoveryAnswer As String, _
                             ByVal Password As String, _
                             ByVal RecoveryQuestion As String, _
                             ByVal RecoveryAnswer As String) _
                             As Boolean

Parameters

SessionID
String - GUID
The current session's GUID in string format. This is a 32-character hexidecimal string in the format:
00000000-0000-0000-0000-000000000000. This is the value returned by the Login() function.
UserID
Integer
A numeric value used to represent a specific user on the system.
CurrentRecoveryAnswer [depricated]
String(0,50)
The current RecoveryAnswer, required to match in order to process Password change.  To be left blank.
Password
String(8,32)
A "strong" password with a minimum length of 8 and maximum length of 32. 
RecoveryQuestion
String(0,50)
A user defined question used to restore lost password or to activate an account with too many failed logins.
RecoveryAnswer
String(0,50)
A user defined answer to the RecoveryQuestion, used to restore lost password or to activate an account with too many failed logins.

Returns

Boolean 
True if successful, false on failure.

Remarks

By default, passwords expire every 180 days. This counter is reset whenever the password is changed.

If CurrentRecoveryAnswer does not match the one in they system, the method will fail. This API requires the logged in user to have administrative control over the user being updated. The CurrentRecoveryAnswer is not processed in this case. A future API will allow the password to be reset w/o being logged in, requiring a matching CurrentRecoveryAnswer.

Loren Data requires strong passwords that include at least one uppercase, one lowercase, one number and one special character. For example This1IsGood!

Example

Visual Basic
[insert code sample]

EventID: 1015

See Also

Users & Authorization Levels
ChangePassword()

© 2008-2011, Loren Data Corp.
All rights reserved.		 ECGrid is a registered service mark of Loren Data Corp.
ECGridOS is a service mark of Loren Data Corp.