Previous Topic Next topic Print topic


Typical Result Codes for Verify

For a Verify request, the most common result code triplets are listed in the table below. These will generally be suitable for most ESM Modules. For an explanation of the response classes (Allow, Deny, Fail, and Unknown), see the section ESF API Calls.

rc return reason Meaning
saf78_SAF_RC_SUCCESS (0) saf78_RC_NORMAL (0) saf78_RS_NORMAL (0) Verification succeeded, no additional information (this is an Allow result)
saf78_SAF_RC_NOT_COMPLETE (4) saf78_RC_NO_DECISION (0) saf78_RS_ESM_NOT_CALLED (0) The ESM Module does not implement this procedure, or it has decided that this request does not apply to it (this is an Unknown result)
saf78_SAF_RC_NOT_COMPLETE (4) saf78_RC_NO_USER_PROFILE (4) saf78_RS_NORMAL (0) The ESM does not have a record for this user (this is an Unknown result)
saf78_SAF_RC_FAILURE (8) saf78_RC_NORMAL (0) saf78_RS_NORMAL (0) The ESM rejected this request, and does not wish to provide any additional information (note this is a Deny result, not a Fail result, despite the name of the associated constant). This code can be used if the organization's security policy requires not revealing information about why a signon request was denied.
saf78_SAF_RC_FAILURE (8) saf78_RC_PWRD_INVALID (8) saf78_RS_NORMAL (0) Verification failed because the supplied password was incorrect (this is a Deny result)
saf78_SAF_RC_FAILURE (8) saf78_RC_PWRD_EXPIRED (12) saf78_RS_NORMAL (0) Verification failed because the supplied password has expired (this is a Deny result). Some ESM Modules will accept the request if it is repeated with a new password supplied in the optional new-password field.
saf78_SAF_RC_FAILURE (8) saf78_RC_PWRD_CHANGE_ERR (16) saf78_RS_NORMAL (0) Verification failed because the supplied new password was not accepted by the ESM (this is a Deny result)
saf78_SAF_RC_FAILURE (8) saf78_RC_USER_REVOKED (28) saf78_RS_NORMAL (0) Verification failed because signon is disabled for the user's account (this is a Deny result)
saf78_SAF_RC_FAILURE (8) saf78_RC_DATABASE_ERROR (92) saf78_RS_NORMAL (0) Verification failed because the ESM Module or its associated ESM was unable to process the request (this is a Fail result)
Previous Topic Next topic Print topic