Function
GUPnPServiceProxyActionnew_from_list
Declaration [src]
GUPnPServiceProxyAction*
gupnp_service_proxy_action_new_from_list (
const char* action,
GList* in_names,
GList* in_values
)
Description [src]
Prepares action action
with parameters in_names
and in_values
to be
sent off to a remote service later with gupnp_service_proxy_call_action()
or
gupnp_service_proxy_call_action_async(). This is mainly useful for language bindings.
After the action call has finished, the results of the call may be
retrived from the GUPnPServiceProxyAction
by using gupnp_service_proxy_action_get_result(),
gupnp_service_proxy_action_get_result_list()
or
gupnp_service_proxy_action_get_result_hash()
GList *in_args = NULL;
in_args = g_list_append (in_args, "InstanceID");
in_args = g_list_append (in_args, "Unit");
in_args = g_list_append (in_args, "Target");
GValue instance = G_VALUE_INIT;
g_value_set_int (&instance, 0);
GValue unit = G_VALUE_INIT;
g_value_set_static_string (&unit, "ABS_TIME");
GValue target = G_VALUE_INIT;
g_value_set_static_string (&target, "00:00:00.000");
GList *in_values = NULL;
in_values = g_list_append (in_values, &instance);
in_values = g_list_append (in_values, &unit);
in_values = g_list_append (in_values, &target);
GUPnPServiceProxyAction *action =
gunp_service_proxy_action_new_from_list ("Seek", in_args, in_values);
GError *error = NULL;
gupnp_service_proxy_call_action_async (proxy, action, NULL, on_action_finished, NULL);
gupnp_service_proxy_action_unref (action);
Parameters
action
-
Type:
const char*
An action.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. in_names
-
Type: A list of
utf8
GList
of ‘in’ parameter names (as strings).The data is owned by the caller of the function. Each element is a NUL terminated UTF-8 string. in_values
-
Type: A list of
const GValue*
GList
of values (asGValue
) that line up within_names
.The data is owned by the caller of the function.
Return value
Type: GUPnPServiceProxyAction
A newly created GUPnPServiceProxyAction
.
The caller of the function takes ownership of the data, and is responsible for freeing it. |