uva_check_password
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 the uva_check_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_check_password (
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.