This function returns am_status_t with one of the following values:
If SSO token is valid, session handle is updated.
If the session is invalid, session handle is updated.
If the input parameter is invalid.
If SSO token service is not initialized. SSO token service must be initialized by calling am_sso_init() before any call to am_sso.
If server returned service not available.
If HTTP error encountered while communicating with server.
If error parsing XML from server.
If access denied while communicating with server.
If any other error occurred.