Commit 5a06a27c authored by Xavier Claessens's avatar Xavier Claessens

Add GetContactByID

parent 3195ec6c
...@@ -186,6 +186,64 @@ ...@@ -186,6 +186,64 @@
<tp:error name="org.freedesktop.Telepathy.Error.Disconnected"/> <tp:error name="org.freedesktop.Telepathy.Error.Disconnected"/>
</tp:possible-errors> </tp:possible-errors>
</method> </method>
<method name="GetContactByID"
<tp:added version="0.UNRELEASED"/>
Return any number of contact attributes for the given identifier.
This is for a single identifier to make it simpler to use for the most
common use case. For multiple contacts case,
<tp:member-ref>GetContactAttributes</tp:member-ref> should be used.
<arg direction="in" name="Identifier" type="s">
An identifier representing a contact.
<arg direction="in" name="Interfaces" type="as"
<tp:docstring xmlns="">
<p>A list of strings indicating which D-Bus interfaces the calling
process is interested in. All supported attributes from these
interfaces, whose values can be obtained without additional network
activity, will be in the reply.</p>
<p>See <tp:member-ref>GetContactAttributes</tp:member-ref> for
<arg direction="out" name="Handle" type="u" tp:type="Contact_Handle">
<tp:docstring xmlns="">
<p>The contact's handle, as returned by <tp:dbus-ref
<arg direction="out" type="a{sv}" name="Attributes"
<tp:docstring xmlns="">
<p>All supported attributes of the contact on
the given interfaces that can be returned without network
round-trips. If contact attributes are not immediately known, the
behaviour is defined by the interface; the attribute should either
be omitted from the result or replaced with a default value.</p>
<p>The contact's attributes will always include at least the
identifier that would be obtained by inspecting the handle
<tp:error name="org.freedesktop.Telepathy.Error.Disconnected"/>
<tp:error name="org.freedesktop.Telepathy.Error.InvalidHandle"/>
</interface> </interface>
</node> </node>
<!-- vim:set sw=2 sts=2 et ft=xml: --> <!-- vim:set sw=2 sts=2 et ft=xml: -->
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment