axl_bool vortex_xml_rpc_invoke ( VortexChannel channel,
XmlRpcMethodCall method_call,
XmlRpcInvokeNotify  reply_notify,
axlPointer  user_data 
)

Perform an asynchronous invocation using the XML-RPC profile.

This function allows to perform an asynchronous invocation on the given channel, that is already running the XML-RPC profile, using as method invocator the method_call provided.

The channel received on this function should be get from:

Once the method is invoked, the reply received is notified on the reply_notify callback.

Because the function will perform the invocation in an asynchronous mode, the caller will not be blocked while calling to this function. If a blocking invocation mode is required check vortex_xml_rpc_invoke_sync.

See also: XmlRpcMethodCall

Parameters
channelThe channel, running the XML-RPC profile, where the invocation will take place.
method_callThe method call invocator, representing the method to be invoked plus its parameters.
reply_notifyThe notify function where the reply will be reported.
user_dataUser defined data that will be passed to the notify function along the reply received.
Returns
axl_true if the invocation was performed (only the RPC call), otherwise axl_false is returned.

References vortex_channel_get_ctx(), vortex_channel_is_ready(), vortex_channel_is_running_profile(), vortex_channel_ref2(), vortex_thread_pool_new_task(), vortex_xml_rpc_channel_status(), VORTEX_XML_RPC_PROFILE, XML_RPC_CHANNEL_NOT_READY, XML_RPC_NOT_XML_RPC_CHANNEL, XML_RPC_WAITING_PREVIOUS, and XmlRpcStateReady.

Referenced by vortex_xml_rpc_invoke_sync().