HSDK Class Descriptions › CaHarvest › HINT32 ChangePassword(LPCTSTR szPassword)

HINT32 ChangePassword(LPCTSTR szPassword)

Changes the CA Harvest SCM password of the currently logged in user.

Notes:

• If new password does not match local password policy, a nonzero result code will be returned. Check with GetLastMessage to see why changing the password failed.
• If your site uses internal authentication (CA Harvest SCM authentication), changing the password is enabled.
• If your site uses external authentication, such as Microsoft Active Directory, this function is disabled; you must change the password using methods provided by the authentication server. For example, if using Microsoft Active Directory, you can change passwords by entering Ctrl+Alt+Del and using the Change Password option.
• If your site uses external authentication, changing passwords fails with an error message.

Owning Class

CaHarvest

Arguments

LPCTSTR szPassword-the Password

Return Value

Returns zero if success, nonzero if failure.

Exceptions

Throws CaException on error.

Example

CaHarvest Harvest;
if( Harvest.ChangePassword( szNewPassword ) ) cout << Harvest.GetLastMessage() << endl;

More information:

• HSDK Programming Fundamentals
• CaException
• SetBroker
• Login
• Logout
• GetLastMessage
• GetCaseSensLogin