Return Values
All user validation interfaces (apart from the uva_initialise function) return an integer return code with the following type:
typedef int UV_RCODE
Return codes are classified as follows:
|
Value |
Description |
|
> 0 |
Success |
|
0 |
Failure (but not an error) |
|
<0 |
Failure (an error condition) |
The following values can be returned. See each interface description to see which values each interface returns.
|
Return Value |
Description |
|
SW_OK |
Success |
|
SW_EOF |
No more users available |
|
ER_HANDLE |
Invalid session handle |
|
ER_PARAM |
Invalid parameter(s) |
|
ER_SYSTEM |
Generic (undefined) error |
|
ER_TOOBIG |
Value is too large for supplied buffer |
|
ER_NOTFOUND |
Unknown user |
|
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 |
|
ER_SECEXPIRED |
Password has expired |
|
ER_SECDISABLED |
This user account is 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 |
|
ER_USERDISABLED |
The account has been disabled |