This function returns one of the following values of the am_status_t enumeration (defined in the <am_types.h> header file):
If the token was refreshed with no errors.
If the sso_token_handle parameter is invalid.
If the Session Service was not initialized with am_sso_init().
If server returned service not available.
If an HTTP error was encountered while communicating with OpenSSO Enterprise.
If an error occurred while parsing XML from OpenSSO Enterprise.
If access was denied while communicating with OpenSSO Enterprise.
If the session validation failed.
If any other error occurred.