This function returns one of the following values of the am_status_t enumeration (defined in the <am_types.h> header file):
If single sign-on token is valid. The information is updated.
If the session is invalid. The information is updated.
If the input parameter is invalid.
If Session Service is not initialized.
If Access Manager returned service not available.
If HTTP error encountered while communicating with Access Manager.
If error parsing XML from Access Manager.
If access is denied while communicating with Access Manager.
If any other error occurred.