Parameters

This function takes the following parameters:

sso_token_handle

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.

---

listener

The listener as described in am_sso_token_listener_func_t.

---

Note –

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

---

args

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.

---