set_request_property
Description:
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 | |
name |
a D-Bus property name |
value |
an arbitrary value for the property |