Returns

This function returns one of the following values of the am_status_t enumeration (defined in the <am_types.h> header file):

AM_SUCCESS

If single sign-on token is valid. The information is updated.

AM_INVALID_SESSION

If the session is invalid. The information is updated.

AM_INVALID_ARGUMENT

If the input parameter is invalid.

AM_SERVICE_NOT_INITIALIZED

If Session Service is not initialized.

AM_SERVICE_NOT_AVAILABLE

If OpenSSO Enterprise returned service not available.

AM_HTTP_ERROR

If HTTP error encountered while communicating with OpenSSO Enterprise.

AM_ERROR_PARSING_XML

If error parsing XML from OpenSSO Enterprise.

AM_ACCESS_DENIED

If access is denied while communicating with OpenSSO Enterprise.

AM_FAILURE

If any other error occurred.