2
<node name="/Channel_Interface_Password" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
4
Copyright (C) 2005, 2006 Collabora Limited
5
Copyright (C) 2005, 2006 Nokia Corporation
6
Copyright (C) 2006 INdT
9
This library is free software; you can redistribute it and/or
10
modify it under the terms of the GNU Lesser General Public
11
License as published by the Free Software Foundation; either
12
version 2.1 of the License, or (at your option) any later version.
14
This library is distributed in the hope that it will be useful,
15
but WITHOUT ANY WARRANTY; without even the implied warranty of
16
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17
Library General Public License for more details.
19
You should have received a copy of the GNU Lesser General Public
20
License along with this library; if not, write to the Free Software
21
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23
<interface name="org.freedesktop.Telepathy.Channel.Interface.Password">
24
<tp:requires interface="org.freedesktop.Telepathy.Channel"/>
25
<tp:flags name="Channel_Password_Flags" value-prefix="Channel_Password_Flag">
26
<tp:flag suffix="Provide" value="8">
28
The ProvidePassword method must be called now for the user to join
33
<method name="GetPasswordFlags">
34
<arg direction="out" type="u">
36
An integer with the logical OR of all the flags set
37
(values of ChannelPasswordFlags)
41
Returns the bitwise-OR of the flags relevant to the password on this
42
channel. The user interface can use this to present information about
43
which operations are currently valid.
46
<tp:error name="org.freedesktop.Telepathy.Error.Disconnected"/>
47
<tp:error name="org.freedesktop.Telepathy.Error.NetworkError"/>
50
<signal name="PasswordFlagsChanged">
51
<arg name="added" type="u">
53
A bitwise OR of the flags which have been set
56
<arg name="removed" type="u">
58
A bitwise OR of the flags which have been cleared
62
Emitted when the flags as returned by GetPasswordFlags are changed.
63
The user interface should be updated as appropriate.
66
<method name="ProvidePassword">
67
<arg direction="in" name="password" type="s">
72
<arg direction="out" type="b">
73
A boolean indicating whether or not the password was correct
76
Provide the password so that the channel can be joined. Must be
77
called with the correct password in order for channel joining to
78
proceed if the 'provide' password flag is set.
81
<tp:error name="org.freedesktop.Telepathy.Error.Disconnected"/>
82
<tp:error name="org.freedesktop.Telepathy.Error.NetworkError"/>
83
<tp:error name="org.freedesktop.Telepathy.Error.InvalidArgument"/>
86
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
87
<p>Interface for channels that may have a password set that users need
88
to provide before being able to join, or may be able to view or change
89
once they have joined the channel.</p>
91
<p>The GetPasswordFlags method and the associated PasswordFlagsChanged
92
signal indicate whether the channel has a password, whether the user
93
must now provide it to join, and whether it can be viewed or changed
98
<!-- vim:set sw=2 sts=2 et ft=xml: -->