Validates an SSO token.
#include "am_sso.h" AM_EXPORT am_status_t am_sso_validate_token(const am_sso_token_handle_t sso_token_handle);
This function takes the following parameters:
SSO token to validate.
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.
This call will go to the server to get the latest session info and update the sso_token_handle input parameter. The sso_token_handle input parameter is updated if the return status is either AM_SUCCESS or AM_INVALID_SESSION. This is different from am_sso_refresh_token() in that it does not update the last access time on the server.