VortexChannel * vortex_xml_rpc_boot_channel_sync ( VortexConnection connection,
const char *  serverName,
const char *  resourceName,
VortexStatus status,
char **  status_message 
)

Perform a synchronous (blocking) XML-RPC channel boot.

This function perform the same operation like vortex_xml_rpc_boot_channel function but in a blocking manner. This function is ideal for batch process and every system that requires a blocking remote method invocation.

In the case that an asynchronous method invocation is required, vortex_xml_rpc_boot_channel should be used.

The function allows to provide references to an optional status and an optional message variables, so the caller could perform a better error reporting.

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 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.
statusAn optional status reference that will be filled with the process termination status.
status_messageAn optional message reference that will be filled with a textual diagnostic, explaining termination status.
Returns
A channel already initialized with the XML-RPC profile or NULL if it fails.

References vortex_async_queue_new(), vortex_async_queue_pop(), vortex_async_queue_ref(), vortex_async_queue_timedpop(), vortex_async_queue_unref(), vortex_connection_get_ctx(), vortex_connection_get_timeout(), vortex_connection_is_ok(), vortex_xml_rpc_boot_channel(), VortexError, and VortexOk.