axlPointer vortex_connection_set_channel_removed_handler ( VortexConnection connection,
VortexConnectionOnChannelUpdate  removed_handler,
axlPointer  user_data 
)

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

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

Parameters
connectionThe connection where the handler is going to be installed. This parameter cannot be null.
removed_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_REMOVE_HANDLER.

References vortex_mutex_lock(), and vortex_mutex_unlock().