Programming Guides › Programming Guide for Perl › CLI Policy Management Methods › User Password State Methods › LastPWChangeTime Method—Sets or Retrieves Time Password Last Changed

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.