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