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 OpenSSO Enterprise returned service not available.
If HTTP error encountered while communicating with OpenSSO Enterprise.
If error parsing XML from OpenSSO Enterprise.
If access is denied while communicating with OpenSSO Enterprise.
If any other error occurred.