uva_change_password_ex

Purpose

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

Warning

You must use this interface instead of the uva_change_password 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_ex (
   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 an extended version of the uva_change_password interface. It is identical to that interface except that it supports the passing in and out of user location information from the SW_DOMAIN user attribute and/or LOGON_OS_LOCATION process attribute. See Password Validation on Windows Systems for more information.