Sun Java System Access Manager 7 2005Q4 C API Reference

am_sso_remove_sso_token_listener()

Removes an SSO token listener for the SSO token’s change events.

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

The session handle containing the SSO token id for the listener.

listener

The token change event listener.

Returns

This function returns am_status_t with one of the following values:

AM_SUCCESS

If the listener was successfully removed.

AM_INVALID_ARGUMENT

If sso_token_id or listener is invalid or NULL.

AM_NOT_FOUND

If listener was not found for the SSO token id.

AM_FAILURE

If any other error occurred.

Details

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