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);
Parameters
| action | 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. | |
| ... |  | 
| Tuples of in parameter name, in parameter type, and in parameter
value, terminated with  | 
Return value
| Returns: | GUPnPServiceProxyAction | 
| A newly created  | |
| The caller of the function takes ownership of the data, and is responsible for freeing it. |