Returns

This function returns am_status_t with one of the following values:

AM_SUCCESS

If session validation was successful and a handle was successfully created.

AM_SERVICE_NOT_INITIALIZED

If SSO token service was not initialized. SSO token service must be initialized by calling am_sso_init() any call to am_sso_* can be made.

AM_INVALID_ARGUMENT

If the session_token_handle_ptr parameter is NULL.

AM_NO_MEMORY

If there was a memory allocation problem.

AM_FAILURE

If any other error occurred.