am_sso_remove_sso_token_listener()

Removes a single sign-on token listener associated with the specified single sign-on token handle.

Details

If am_sso_add_listener() was called more than once for the same listener function, all instances of the listener function will be removed.

Syntax

#include "am_sso.h"
AM_EXPORT am_status_t
am_sso_remove_sso_token_listener(const am_sso_token_handle_t sso_token_handle,
                                 const am_sso_token_listener_func_t listener);

Parameters

This function takes the following parameters:

sso_token_handle

Pointer to a am_sso_token_handle_t type.

listener

The listener as described in am_sso_token_listener_func_t.

Returns

This function returns one of the following values of the am_status_t enumeration (defined in the <am_types.h> header file):

AM_SUCCESS

If the listener was successfully removed.

AM_INVALID_ARGUMENT

If the listener is NULL.

AM_NOT_FOUND

If listener was not found.

AM_FAILURE

If any other error occurred.