set_file_transfer_uri


Description:

[ Version ( since = "0.19.0" ) ]
public void set_file_transfer_uri (string uri)

Configure this channel request to provide other local Telepathy components with the URI of the file being sent.

Unlike most properties on a file transfer channel, this information is not sent to the recipient of the file; instead, it is signalled on D-Bus for use by other Telepathy components.

The URI should usually be a file URI as defined by RFC 1738 §3.10 (for instance, file:///path/to/file or file://localhost/path/to/file). If a remote resource is being transferred to a contact, it may have a different scheme, such as http.

Even if this method is used, the connection manager will not read the file from disk: the handler for the channel is still responsible for streaming the file. However, providing the URI allows a local logger to log which file was transferred, for instance.

If this functionality is not supported by the connection manager, or if this method is used on a request that is not actually a file transfer, the channel request will fail. Use supports_file_transfer_uri to determine whether outgoing file transfers can have a URI.

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

Parameters:

this

a AccountChannelRequest

uri

the source URI for the file