uva_change_password

Purpose

Decrypts the supplied encrypted user name and passwords and then change the password for the supplied user to the supplied password.

Warning

You must use the uva_change_password_ex interface instead of this interface if you use the SW_DOMAIN or LOGON_OS_LOCATION attributes to specify the location where a user’s password should be validated. See Password Validation on Windows Systems for more information.

Prototype

UV_RCODE uva_change_password (
   UV_SH uvsh, 
   UV_PSTR pEncrUserName, 
   UV_PSTR pEncrOldPassword, 
   UV_PSTR pEncrNewPassword 
);

Parameters

Parameter	Type	Description
uvsh	IN	Session handle
pEncrUserName	IN	Pointer to encrypted VPIU name
pEncrOldPassword	IN	Pointer to encrypted VPIU current password
pEncrNewPassword	IN	Pointer to encrypted VPIU new password

Return Values

Value	Description
SW_OK	Success
ER_NOTFOUND	Unknown user
ER_HANDLE	Invalid session handle
ER_PARAM	Invalid parameter(s)
ER_SYSTEM	Generic (undefined) error
ER_SECCANTCHNG	Cannot change password for this user
ER_SECBADNEWPSWD	New password is invalid
ER_SECBADUSER	Unknown user
ER_SECUNKNOWN	Generic (undefined) security error
ER_SECBADPSWD	Password is invalid
ER_SECBADPERMS	Permissions are incorrect for this operation

See Return Values for a complete list of possible return values.

Remarks

This interface is currently used in the iProcess Work Queue Manager.