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


This function takes the following parameters:


Pointer to the session information object containing the session token to which the listener corresponds. The handle will be filled with the session information from the notification message, overwriting any existing contents.

Note –

The session token is a randomly-generated string that represents an authenticated user.


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.


Arguments to pass to the listener.


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.