Download message and store it in the target file.

If an empty target file is given, a temporary file will be automatically generated.

The returned path represents the newly created transfer, which should be used to find out if the content has been successfully transferred or if the operation fails.

The properties of this transfer are also returned along with the object path, to avoid a call to GetProperties, see org.bluez.obex.Transfer(5) for the possible list of properties.

Possible errors:

Folder which the message belongs to

Message subject

Message timestamp

Message sender name

Message sender address

Message Reply-To address

Message recipient name

Message recipient address

Message type

Possible values:

Message size in bytes

Message reception status

Possible values:

Message priority flag

Message read flag

Message deleted flag

Message sent flag

Message protected flag