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

Parameters

This function takes the following parameters:

listener

The listener as described in am_sso_token_listener_func_t.


Note –

When the listener is called, updated session information from OpenSSO Enterprise is passed in a temporary sso_token_handle.


args

Pointer to application-defined arguments to pass to the listener.

dispatch_to_sep_thread

Takes one of the values based on the boolean_t (defined in the <am_types.h> header file) that indicates whether the listener function should be called in the calling thread or dispatched to a thread from the internal thread pool managed by the C SDK.


Note –

Calling the listener in a thread from an internal thread pool allows am_notify() to return immediately upon parsing the notification message rather than waiting for the listener functions to finish before returning.