uva_check_password_ex

Purpose

Decrypt the supplied encrypted user and password and then return a value indicating whether the password for the supplied user is valid.

Warning

You must use this interface instead of the uva_check_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_check_password_ex (
   UV_SH uvsh, 
   UV_PSTR pEncrUserName, 
   UV_PSTR pEncrPassword
); 

Parameters

Parameter	Type	Description
uvsh	IN	Session handle
pEncrUserName	IN	Pointer to encrypted VPIU name
pEncrOldPassword	IN	Pointer to encrypted VPIU 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_SECEXPIRED	Password has expired
ER_SECDISABLED	This user account is disabled
ER_SECBADUSER	Unknown user
ER_SECUNKNOWN	Generic (undefined) security error
ER_SECBADPSWD	Password is invalid
ER_SECBADPERMS	Permissions are incorrect for this operation
ER_USERDISABLED	The account has been disabled
ER_SECBADWKSTN	Login/Validation is not allowed from this location
ER_SECBADHOURS	Login/Validation is not allowed at this time
ER_SECLOCKOUT	The account has been locked

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

Remarks

This interface is an extended version of the uva_check_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.