void vortex_xml_rpc_boot_channel ( VortexConnection connection,
const char *  serverName,
const char *  resourceName,
VortexXmlRpcBootNotify  process_status,
axlPointer  user_data 
)

Perform initial boot step to get confirmation from remote server to accept incoming XML-RPC under the given resource.

XML-RPC invocation follows the next diagram:

xml-rpc-invocation.png
XML-RPC invocation diagram

From the execution of this function, a new channel (VortexChannel) is get, already initialized under the XML-RPC profile. This channel will be used vortex_xml_rpc_invoke.

Parameters
connectionThe connection where the XML-RPC invocation will be performed, actually, the connection where the XML-RPC channel will be created.
serverNameFor those connection that didn't server serverName virtual host mechanism, this value will be used. Keep in mind that previous channels could be already negotiated the serverName identity making this value to be ignored. The serverName value is negotiated for the first channel requesting it, but once done, its value is global to the session, that is the given connection you are using. This is parameter is optional. If a NULL value is provided, the serverName attribute will be not used.
resourceNameThe resource name requested to be accepted. This parameter is not optional. If a NULL value is provided, the resource "/" will be used as default value.
process_statusA mandatory notification handler where the XML-RPC initial boot result will be notified.
user_dataUser defined data to be passed in to the process_status notify handler.

References vortex_connection_get_ctx(), vortex_connection_is_ok(), vortex_thread_pool_new_task(), and VortexError.

Referenced by vortex_xml_rpc_boot_channel_sync().