Invalidates or destroys the session on the server.
#include "am_sso.h" AM_EXPORT am_status_t am_sso_invalidate_token(const am_sso_token_handle_t sso_token_handle);
This function takes the following parameters:
SSO token handle of session to be invalidated.
This function returns am_status_t with one of the following values:
If session was successfully invalidated.
If the sso_token_handle is invalid.
If the SSO token service was not initialized with am_sso_init().
If server returned service not available.
If HTTP error encountered while communicating with server.
If error parsing XML from server.
If access denied while communicating with server.
If any other error occurred.
If successful the session handler in input argument will have state invalid after this call.
Note: Does not free the sso_token_handle input parameter. Call am_sso_destroy_sso_token_handle() to free memory for the handle itself.