Sun OpenSSO Enterprise 8.0 C API Reference for Application and Web Policy Agent Developers

am_sso_remove_listener()

Removes a single sign-on token listener.

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_listener(const am_sso_token_listener_func_t listener);

Parameters

This function takes the following parameter:

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.