Programming Guides › Programming Guide for Perl › CLI Policy Management Methods › CLI User Password State Methods

CLI User Password State Methods

DisabledTime Method—Sets or Retrieves Time Object Was Disabled

The DisabledTime method sets or retrieves the time that the user object was disabled. The time is represented as the number of seconds that have elapsed since a particular instant in time that varies from system to system. One common representation is the number of seconds that have elapsed since 00:00:00 1/1/1970 UTC (Coordinated Universal Time).

Syntax

The DisabledTime method has the following format:

Netegrity::PolicyMgtUserPasswordState‑>DisabledTime([time])

Parameters

The DisabledTime method accepts the following parameter:

time (long)

(Optional) Specifies a new time for when the user object was disabled.

Return Value

The DisabledTime method returns the following value:

• time (long)

  Specifies the new or existing time that the user object was disabled.

LastPWChangeTime Method—Sets or Retrieves Time Password Last Changed

The LastPWChangeTime method sets or retrieves the time that the user's password was last changed. The time is represented as the number of seconds that have elapsed since a particular instant in time that varies from system to system. One common representation is the number of seconds that have elapsed since 00:00:00 1/1/1970 UTC (Coordinated Universal Time).

Syntax

The LastPWChangeTime method has the following format:

Netegrity::PolicyMgtUserPasswordState‑>LastPWChangeTime([time])

Parameters

The LastPWChangeTime method accepts the following parameter:

time (long)

Specifies a new time for when the user's password was last changed.

Return Value

The LastPWChangeTime method returns one of the following values:

• time (long)

  Specifies the new or existing time that the user's password was changed.

• value = 0

  Specifies that the user started to change the password, but did not complete the procedure.

LastLoginTime Method—Sets or Retrieves Last Login Time

The LastLoginTime method sets or retrieves the time that the user last logged in successfully. The time is represented as the number of seconds that have elapsed since a particular instant in time that varies from system to system. One common representation is the number of seconds that have elapsed since 00:00:00 1/1/1970 UTC (Coordinated Universal Time).

Syntax

The LastLoginTime method has the following format:

Netegrity::PolicyMgtUserPasswordState‑>LastLoginTime([time])

Parameters

The LastLoginTime method accepts the following parameter:

time (long)

(Optional) Specifies a new time for when the user last logged in successfully.

Return Value

The LastLoginTime method returns the following value:

• time (long)

  Specifies the new or existing time that the user last logged in successfully.

LoginFailures Method—Sets or Retrieves Number of Login Failures

The LoginFailures method sets or retrieves the number of times the user failed to log in since the user's last successful login.

Syntax

The LoginFailures method has the following format:

Netegrity::PolicyMgtUserPasswordState‑>LoginFailures([count])

Parameters

The LoginFailures method accepts the following parameter:

count (int)

(Optional) Specifies a new value for the number of login failures.

Return Value

The LoginFailures method returns one of the following values:

• count (int)

  Specifies the new or existing number of login failures since the user's last successful login.