VortexChannel* vortex_channel_pool_get_next_ready_full ( VortexChannelPool pool,
axl_bool  auto_inc,
axlPointer  user_data 
)

Allows to get the next channel available on the provided pool, providing a pointer that will be passed to the create channel handler.

This function works the same way like vortex_channel_pool_get_next_ready but allows to provide a pointer that is passed to the VortexChannelPoolCreate handler configured at vortex_channel_pool_new_full. In the case you didn't configure a creation channel handler, this function is not useful.

Once the channel was used, you should use vortex_channel_pool_release_channel to return the channel to the pool, making it usable by other invocation. The concept is to release the channel as soon as possible.

See vortex_channel_pool_get_next_ready function for more information.

Parameters
poolThe channel pool where a ready channel is required.
auto_incaxl_true to signal the function to create a new channel if there is not available.
user_dataUser defined data to be passed to the VortexChannelPoolCreate function.
Returns
A newly allocated channel ready to use, or NULL if it fails.

References vortex_channel_get_number(), vortex_channel_set_data(), vortex_connection_get_ctx(), and vortex_connection_get_id().

Referenced by vortex_channel_pool_get_next_ready(), and vortex_xml_rpc_channel_pool_get_next().