[Telepathy] [Bug 17555] Need API to check if a handle is channel specific or not

[bugzilla-daemon at freedesktop.org]

http://bugs.freedesktop.org/show_bug.cgi?id=17555





--- Comment #1 from Dafydd Harries <dafydd.harries at collabora.co.uk>  2008-09-13 10:03:23 PST ---
The use case here is telling whether a handle you see in a PresenceUpdate is
channel-specific or not.

I think this should be a method on the connection interface:

  GetHandleOwners :: au -> a{u(uo)}

That is, return a map of handle to (owner handle, path the channel is specific
to). If an input handle is not channel-specific, the dictionary entry is
omitted. If the handle has no known owner, the owner handle is 0.

This works if handles can only be specific to one channel at a time. Simon
suggests that a handle might be specific to multiple channels but I forget his
rationale and it seems quite bizarre to me. If we do need to support that (I
hope we don't), we can have:

  GetHandleOwners :: au -> a{u(uao)}

We can indicate non-channel-specificity by non-inclusion or having the array of
channel paths be empty.

With regards to backwards compatibility, do we need to put this in its own
interface?

In terms of implementation, I suspect most connection managers will end up
iterating over all the chanels they have internally.


-- 
Configure bugmail: http://bugs.freedesktop.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.