Programming Guides › Programming Guide for Perl › CLI Policy Management Methods › User Methods › DisablePwdExpired Method—Sets or Retrieves Disabled-by-Password-Expired Flag

DisablePwdExpired Method—Sets or Retrieves Disabled-by-Password-Expired Flag

The DisablePwdExpired method sets or retrieves the disabled-by-password-expired flag that specifies whether the user account is disabled because the password expired.

Syntax

The DisablePwdExpired method has the following format:

Netegrity::PolicyMgtUser‑>DisablePwdExpired([disableFlag])

Parameters

The DisablePwdExpired method accepts the following parameter:

disableFlag (int)

(Optional) Specifies a new value for the disabled-by-password-expired flag.

• value = 1

  Specifies that the user account is disabled because the password expired.

• value = 0

  Specifies that the user account is not disabled because the password expired.

• Note: The user account can be disabled for other reasons. For more information, see Remarks.

Return Value

The DisablePwdExpired method returns the new or existing value for the disabled-by-password-expired flag:

• value = 1

  Specifies that the user account is disabled because the password expired.

• value = 0

  Specifies that the user account is not disabled because the password expired.

  Note: The user account can be disabled for other reasons. For more information, see Remarks.

• value = -1

  Specifies that the call is unsuccessful.

Remarks

User accounts can be disabled for one or more of the following reasons:

• The administrator disabled the user account.

  For more information, see the method PolicyMgtUser‑>DisableByAdmin.

• Account inactivity exceeded the time allowed.

  For more information, see the method PolicyMgtUser‑>DisableInactive.

• The number of login failures exceeded the maximum allowed.

  For more information, see the method PolicyMgtUser‑>DisableMaxLoginFail.

• The password expired.