set_request_property


Description:

[ Version ( since = "0.19.0" ) ]
public void set_request_property (string name, Variant value)

Configure this channel request to include the given property, as documented in the Telepathy D-Bus API Specification or an implementation-specific extension.

Using this method is not recommended, but it can be necessary for experimental or implementation-specific interfaces.

If the property is not supported by the protocol or channel type, the channel request will fail. Use Capabilities and the Telepathy D-Bus API Specification to determine which properties are available.

If value is a floating reference, this method takes ownership of it by using g_variant_ref_sink. This allows convenient inline use of Variant constructors:

tp_account_channel_request_set_request_property (acr, "com.example.Int",
g_variant_new_int32 (17));
tp_account_channel_request_set_request_property (acr, "com.example.String",
g_variant_new_string ("ferret"));

It is an error to provide a value which contains types not supported by D-Bus.

This function can't be called once this has been used to request a channel.

Parameters:

this

a AccountChannelRequest

name

a D-Bus property name

value

an arbitrary value for the property