Invalidates or destroys the session on OpenSSO Enterprise associated with the single sign-on token handle.
am_sso_invalidate_token() does not free the sso_token_handle parameter. You must call am_sso_destroy_sso_token_handle() to free the memory for the handle itself.
#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 parameter:
Pointer to a am_sso_token_handle_t type.
If successful, the single sign-on token handle will have an invalid state after this call.
This function returns one of the following values of the am_status_t enumeration (defined in the <am_types.h> header file):
If session was successfully invalidated.
If the sso_token_handle parameter is NULL.
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 any other error occurred.