Sm_PolicyApi_UserPasswordState

Programming Guides › Programming Guide for C › Policy Management API Guidance › Policy Management API Data Structures › Sm_PolicyApi_UserPasswordState_t

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.

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 SiteMinder, 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().