This function returns one of the following values of the am_status_t enumeration (defined in the <am_types.h> header file):
If session validation was successful and a single sign-on token handle was successfully created.
If the Session Service was not initialized.
If the session_token_handle_ptr parameter is NULL.
If there was a memory allocation problem.
If any other error occurred.