axl_bool vortex_xml_rpc_method_call_add_value ( XmlRpcMethodCall method_call,
XmlRpcMethodValue value 
)

Allows to add the given XmlRpcMethodValue in the next parameter position available.

This function allows to add created XmlRpcMethodValue into the given XmlRpcMethodCall following the position of the call ordering.

Here is an example where a method with two parameters is created and then these two parameter values are added sequentially:

1 XmlRpcMethodCall * method_call;
2 XmlRpcMethodValue * value;
3 
4 // create a method call object setting that it will have only 1
5 // parameter.
6 method_call = method_call_new ("examples.getStateName", 1);
7 
8 // create the value and add it
9 value = method_value_new (XML_RPC_INT_VALUE,
10  PTR_TO_INT(41));
11 
12 // add the value into the invocator object
13 method_call_add_value (method_call, value);
14 
15 // create the next value
16 value = method_value_new (XML_RPC_STRING_VALUE, "test");
17 
18 // add the value into the invocation object
19 method_call_add_value (method_call, value);

As we have observed from the example, the parameters are added as they are created, then this function keeps tracking about the position where the next element added should be stored. Moreover, the function checks you don't add more parameters than the value configured while creating the XmlRpcMethodCall object, at method_call_new.

The function will fail if some of the parameters received are NULL or the caller is trying to add more parameter than the XmlRpcMethodCall could accept. The function will not perform any copy from data received.

Parameters
method_callThe XmlRpcMethodCall object where the value will be added.
valueThe XmlRpcMethodValue to be added.
Returns
axl_true if the operation was completed, otherwise axl_false is returned.

Referenced by vortex_xml_rpc_method_call_create_value(), and vortex_xml_rpc_method_call_create_value_from_string().