From: Luiz Augusto von Dentz <luiz.von.dentz@xxxxxxxxx> GetMessage takes the message handle, which can be discovered using GetMessageListing, and file location where the contents of the message will be stored. It returns the transfer object and its properties so the user application can track progress of the operation. --- doc/client-api.txt | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/doc/client-api.txt b/doc/client-api.txt index 1ad9001..cf16a6a 100644 --- a/doc/client-api.txt +++ b/doc/client-api.txt @@ -385,6 +385,22 @@ Methods void SetFolder(string name) boolean Sent: Message sent flag boolean Protected: Message protected flag + object, dict GetMessage(string handle, string targetfile) + + Download message by its handle, the message handle can + be discovered using GetMessageListing, 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. + Transfer hierarchy ================== -- 1.7.10.2 -- To unsubscribe from this list: send the line "unsubscribe linux-bluetooth" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
