Sm_PolicyApi_UserPasswordState_t

Information regarding all PasswordState virtual attributes is returned using the SmPolicyApi_UserPasswordState_t structure. This structure coexists with a User object, which is restricted by the UserDirectory OID and a User DN string. The structure can be retrieved, created, or updated through the C Policy Management API.
casso10
Information regarding all PasswordState virtual attributes is returned using the SmPolicyApi_UserPasswordState_t structure. This structure coexists with a User object, which is restricted by the UserDirectory OID and a User DN string. The structure can be retrieved, created, or updated through the C Policy Management API.
Syntax
typedef struct Sm_PolicyApi_UserPasswordState_s
{
int iLoginFailures;
time_t tLastLogin;
time_t tPrevLogin;
time_t tDisabled;
time_t tLastPWChange;
} Sm_PolicyApi_UserPasswordState_t;
Field
Description
iLoginFailures
Specifies how many times the user has failed to log in since the last successful login.
tLastLogin
Specifies the last time the user successfully logged in.
tPrevLogin
Specifies the second-to-last time the user successfully logged in.
tDisabled
Specifies the time the user was disabled.
tLastPWChange
Specifies the last time the user changed his password.
If this value updates the user directory setting for the last time the password was changed, and the password is reset outside of
CA Single Sign-On
, the password policy preventing password reuse may not work as expected.
The value 0 may be returned in this field in the following cases:
The user begins the procedure to change his password but does not complete it.
Password history is cleared through a call to Sm_PolicyApi_SetUserPasswordState().