Determining whether Force Password Reset is On for the User (GetForcePasswordResetOnNextLogin and SetForcePasswordResetOnInitialLogin)

icon_info.gif

Available in EFT Server 6.2 and later.

The ICIClientSettings::GetForcePasswordResetOnNextLogin and SetForcePasswordResetOnInitialLogin methods allow you to retrieve or specify whether the option to force the user to change their password on next login is on. If the option allowing this client to change their password is not inherited (i.e., is set to value other than abInherited), this option overrides Site’s Force Password Reset On Initial Login property value. Please note if the option is ON, it does not mean the user will necessarily be forced to change the password on next login, because the user’s password might be already changed since the admin had switched the option from OFF to ON. To unconditionally force the user to change password on next login, use ICIClientSettings::ForcePasswordChange method.

HRESULT SetForcePasswordResetOnInitialLogin(

[in] VARIANT_BOOL val); // True => the option to force password

// change on next login is ON

HRESULT GetForcePasswordResetOnInitialLogin(

[out, optional] VARIANT *pInherited, // Is the option value inherited

// from higher level (True, False)?

[out, retval] VARIANT_BOOL *pVal); // value of the option to force

// password change on next login

Example (VBScript):

Specifying:

client.SetChangePwd abTrue ‘override “Allow change password” option first

client.SetForcePasswordResetOnInitialLogin False

Retrieving:

If client.GetForcePasswordResetOnInitialLogin(isInherited) Then

If isInherited Then

MsgBox "The option to reset password is turned on from site"

End If

End If