axlPointer vortex_connection_set_channel_added_handler ( VortexConnection connection,
VortexConnectionOnChannelUpdate  added_handler,
axlPointer  user_data 
)

Allows to configure a handler which is executed once a channel is added to the provided connection.

This could be used to implement some init policy once the channel is added to the connection. The function support adding several handlers.

Parameters
connectionThe connection where the handler is going to be installed. This parameter cannot be null.
added_handlerThe handler to be called once the even happens. This parameter cannot be null.
user_dataA reference to the user data to be passed to the function.
Returns
An identifier pointer that can be used later to remove the handler to avoid receiving more notifications. To remove the handler installed use vortex_connection_remove_handler with the handler type CONNECTION_CHANNEL_ADD_HANDLER.

References vortex_mutex_lock(), and vortex_mutex_unlock().