GetUserPwdAging
The function GetUserPwdAging gets the age of the password for a specified user — that is, the time remaining until the password expires, or if it has expired, the time since it expired.
| Function | Group | Execution | Windows | Embedded | Thin Client | Mobile Access |
|---|---|---|---|---|---|---|
| GetUserPwdAging | Security | Synchronous | Supported | Supported | Supported | Not supported |
Syntax
GetUserPwdAging(strUser)
- strUser
- The name of the user.
Returned value
This function returns the following possible values:
| Value | Description |
|---|---|
| less than 0 | Number of hours since the password expired. |
| 0 | The specified user is not logged on. |
| greater than 0 | Number of hours until the password expires. |
Note: If the function is not executed correctly (e.g., if the specified user name is invalid), or if the specified user is not logged on, then the function also returns BAD quality.
Examples
Get the age of the password for the user “John”:
GetUserPwdAging("John")
Get the age of the password for the user who is currently logged on:
GetUserPwdAging(UserName)