Refreshes the session information in the SSOToken associated with the specified single sign-on token handle.
am_sso_refresh_token() goes to OpenSSO Enterprise to retrieve the latest session information with which to update the SSOToken. This is similar in functionality to am_sso_validate_token() however, am_sso_refresh_token() also refreshes the last access time of the session.
#include "am_sso.h" AM_EXPORT am_status_t am_sso_refresh_token(const am_sso_token_handle_t sso_token_handle);
This function takes the following parameter:
Pointer to a am_sso_token_handle_t type.
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.