Programming Guides › Programming Guide for Perl › CLI Policy Management Methods › User Methods › ForcePwdChange Method—Sets or Retrieves Force-Password-Change Flag

ForcePwdChange Method—Sets or Retrieves Force-Password-Change Flag

The ForcePwdChange method sets or retrieves the force-password-change flag that specifies whether to force a password change at the next user login.

Syntax

The ForcePwdChange method has the following format:

Netegrity::PolicyMgtUser‑>ForcePwdChange([forceFlag])

Parameters

The ForcePwdChange method accepts the following parameter:

forceFlag (int)

(Optional) Specifies whether to force a password change at the next user login.

• value = 1

  Specifies forcing a password change at the next user login.

• value = 0

  Specifies not forcing a password change at the next user login.

Return Value

The ForcePwdChange method returns the new or existing value for the force-password-change flag.

• value = 1

  Specifies forcing a password change at the next user login.

• value = 0

  Specifies not forcing a password change at the next user login.

• value = -1

  Specifies that the call is unsuccessful.