Function

GUPnPServiceProxyActionnew_plain

Declaration [src]

GUPnPServiceProxyAction*
gupnp_service_proxy_action_new_plain (
  const char* action
)

Description [src]

Prepares action action with to be sent off to a remote service later with gupnp_service_proxy_call_action() or gupnp_service_proxy_call_action_async() if no arguments required or by adding more parameters with gupnp_service_proxy_action_add()

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()

“`c GUPnPServiceProxyAction *action = gupnp_service_proxy_action_new_plain (“GetVolume”); gupnp_service_proxy_action_add (action, “InstanceID”, value_instance); gupnp_service_proxy_action_add (action, “Channel”, value_channel); ““

Available since:

1.6.6

Parameters

`action`	`const char*`
	The name of a remote action to call.
	The data is owned by the caller of the function.
	The string is a NUL terminated UTF-8 string.

Return value

Returns:	`GUPnPServiceProxyAction`
	A newly created `GUPnPServiceProxyAction`.
	The caller of the function takes ownership of the data, and is responsible for freeing it.