VortexConnection * vortex_listener_new_full ( VortexCtx ctx,
const char *  host,
const char *  port,
VortexListenerReadyFull  on_ready_full,
axlPointer  user_data 
)

Creates a new listener, allowing to get the connection that represents the listener created with the optional handler (VortexListenerReadyFull).

This function provides the same functionality than vortex_listener_new and vortex_listener_new2 but allowing to get the connection (VortexConnection) representing the listener, by configuring the optional handler on_ready_full (VortexListenerReadyFull).

Parameters
ctxThe context where the operation will be performed.
hostThe host to listen on.
portThe port to listen on.
on_ready_fullA optional callback to get a notification when vortex listener is ready to accept requests.
user_dataA user defined pointer to be passed in to on_ready handler.
Returns
The listener connection created, or NULL if the optional handler is provided (on_ready).

NOTE: the reference returned is only owned by the vortex engine. This is not the case of vortex_connection_new where the caller acquires automatically a reference to the connection (as well as the vortex engine).

In this case, if your intention is to own a reference to the listener for later operations, you must call to vortex_connection_ref to avoid losing the reference if the system drops the connection. In the same direction, you can't call to vortex_connection_close if you don't own the reference returned by this function.

To close immediately a listener you can use vortex_connection_shutdown.

References VORTEX_IPv4.