Function
GUPnPServiceProxyActionnew
Declaration [src]
GUPnPServiceProxyAction*
gupnp_service_proxy_action_new (
  const char* action,
  ...
)
Description [src]
Prepares action action with parameters Varargs to be sent off to
a remote service later with gupnp_service_proxy_call_action() or gupnp_service_proxy_call_action_async().
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()
GUPnPServiceProxyAction *action =
        gupnp_service_proxy_action_new ("GetVolume",
                                        // Parameters
                                        "InstanceID", G_TYPE_INT, 0,
                                        "Channel", G_TYPE_STRING, "Master",
                                        NULL);
GError *error = NULL;
gupnp_service_proxy_call_action (proxy, action, NULL, &error);
if (error != NULL) {
        g_warning ("Failed to call GetVolume: %s", error->message);
        g_clear_error (&error);
        return;
}
guint16 volume = 0;
if (!gupnp_service_proxy_action_get_result (action,
                                            &error,
                                            "CurrentVolume", G_TYPE_UINT, &volume,
                                            NULL)) {
        g_message ("Current Volume: %u", volume);
}
gupnp_service_proxy_action_unref (action);
This function is not directly available to language bindings.
Parameters
- action
- 
            Type: const char*The name of a remote action to call. The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. 
- ...
- 
            Type: Tuples of in parameter name, in parameter type, and in parameter value, terminated with NULL.
Return value
Type: GUPnPServiceProxyAction
A newly created GUPnPServiceProxyAction.
| The caller of the function takes ownership of the data, and is responsible for freeing it. |