← Back to branch summary

~ubuntu-branches/ubuntu/utopic/telepathy-glib/utopic

« back to all changes in this revision

Viewing changes to docs/reference/html/telepathy-glib-simple-password-manager.html

  • Committer: Package Import Robot
  • Author(s): Simon McVittie
  • Date: 2014-09-16 15:49:50 UTC
  • mfrom: (60.1.5 sid)
  • Revision ID: package-import@ubuntu.com-20140916154950-krvowuvofhu8u6sp
Tags: 0.24.1-1
* New upstream stable release
* debian/copyright: clean up syntax (*.[ch] is unsupported),
  drop deleted files
* debian/watch: only match 0.x versions, 1.0 will be a separate
  source package

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/html/telepathy-glib-simple-password-manager.html
2
2
<html>
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
 
<title>telepathy-glib API Reference Manual: TpSimplePasswordManager</title>
 
5
<title>TpSimplePasswordManager</title>
6
6
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7
7
<link rel="home" href="index.html" title="telepathy-glib API Reference Manual">
8
8
<link rel="up" href="ch-service-base.html" title="Service-side implementation">
9
9
<link rel="prev" href="telepathy-glib-base-password-channel.html" title="TpBasePasswordChannel">
10
10
<link rel="next" href="telepathy-glib-base-client.html" title="TpBaseClient">
11
 
<meta name="generator" content="GTK-Doc V1.20 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.19 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
 
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
16
 
<td width="100%" align="left" class="shortcuts">
17
 
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> 
18
 
                  <a href="#telepathy-glib-simple-password-manager.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 
19
 
                  <a href="#telepathy-glib-simple-password-manager.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces"> <span class="dim">|</span> 
20
 
                  <a href="#telepathy-glib-simple-password-manager.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties"> <span class="dim">|</span> 
21
 
                  <a href="#telepathy-glib-simple-password-manager.properties" class="shortcut">Properties</a></span>
22
 
</td>
23
 
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
24
 
<td><a accesskey="u" href="ch-service-base.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
25
 
<td><a accesskey="p" href="telepathy-glib-base-password-channel.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
26
 
<td><a accesskey="n" href="telepathy-glib-base-client.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
27
 
</tr></table>
 
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
 
16
<tr valign="middle">
 
17
<td><a accesskey="p" href="telepathy-glib-base-password-channel.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
 
18
<td><a accesskey="u" href="ch-service-base.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
 
19
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
 
20
<th width="100%" align="center">telepathy-glib API Reference Manual</th>
 
21
<td><a accesskey="n" href="telepathy-glib-base-client.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 
22
</tr>
 
23
<tr><td colspan="5" class="shortcuts">
 
24
<a href="#telepathy-glib-simple-password-manager.synopsis" class="shortcut">Top</a>
 
25
                   | 
 
26
                  <a href="#telepathy-glib-simple-password-manager.description" class="shortcut">Description</a>
 
27
                   | 
 
28
                  <a href="#telepathy-glib-simple-password-manager.object-hierarchy" class="shortcut">Object Hierarchy</a>
 
29
                   | 
 
30
                  <a href="#telepathy-glib-simple-password-manager.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
 
31
                   | 
 
32
                  <a href="#telepathy-glib-simple-password-manager.properties" class="shortcut">Properties</a>
 
33
</td></tr>
 
34
</table>
28
35
<div class="refentry">
29
36
<a name="telepathy-glib-simple-password-manager"></a><div class="titlepage"></div>
30
37
<div class="refnamediv"><table width="100%"><tr>
32
39
<h2><span class="refentrytitle"><a name="telepathy-glib-simple-password-manager.top_of_page"></a>TpSimplePasswordManager</span></h2>
33
40
<p>TpSimplePasswordManager — a simple X-TELEPATHY-PASSWORD channel manager</p>
34
41
</td>
35
 
<td class="gallery_image" valign="top" align="right"></td>
 
42
<td valign="top" align="right"></td>
36
43
</tr></table></div>
37
 
<div class="refsect1">
38
 
<a name="telepathy-glib-simple-password-manager.functions"></a><h2>Functions</h2>
39
 
<div class="informaltable"><table width="100%" border="0">
40
 
<colgroup>
41
 
<col width="150px" class="functions_return">
42
 
<col class="functions_name">
43
 
</colgroup>
44
 
<tbody>
45
 
<tr>
46
 
<td class="function_type">
47
 
<a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="returnvalue">TpSimplePasswordManager</span></a> *
48
 
</td>
49
 
<td class="function_name">
50
 
<a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-new" title="tp_simple_password_manager_new ()">tp_simple_password_manager_new</a> <span class="c_punctuation">()</span>
51
 
</td>
52
 
</tr>
53
 
<tr>
54
 
<td class="function_type">
55
 
<span class="returnvalue">void</span>
56
 
</td>
57
 
<td class="function_name">
58
 
<a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-async" title="tp_simple_password_manager_prompt_async ()">tp_simple_password_manager_prompt_async</a> <span class="c_punctuation">()</span>
59
 
</td>
60
 
</tr>
61
 
<tr>
62
 
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Strings.html#GString"><span class="returnvalue">GString</span></a> *
63
 
</td>
64
 
<td class="function_name">
65
 
<a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-finish" title="tp_simple_password_manager_prompt_finish ()">tp_simple_password_manager_prompt_finish</a> <span class="c_punctuation">()</span>
66
 
</td>
67
 
</tr>
68
 
<tr>
69
 
<td class="function_type">
70
 
<span class="returnvalue">void</span>
71
 
</td>
72
 
<td class="function_name">
73
 
<a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-for-channel-async" title="tp_simple_password_manager_prompt_for_channel_async ()">tp_simple_password_manager_prompt_for_channel_async</a> <span class="c_punctuation">()</span>
74
 
</td>
75
 
</tr>
76
 
<tr>
77
 
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Strings.html#GString"><span class="returnvalue">GString</span></a> *
78
 
</td>
79
 
<td class="function_name">
80
 
<a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-for-channel-finish" title="tp_simple_password_manager_prompt_for_channel_finish ()">tp_simple_password_manager_prompt_for_channel_finish</a> <span class="c_punctuation">()</span>
81
 
</td>
82
 
</tr>
83
 
</tbody>
84
 
</table></div>
85
 
</div>
86
 
<div class="refsect1">
87
 
<a name="telepathy-glib-simple-password-manager.properties"></a><h2>Properties</h2>
88
 
<div class="informaltable"><table border="0">
89
 
<colgroup>
90
 
<col width="150px" class="properties_type">
91
 
<col width="300px" class="properties_name">
92
 
<col width="200px" class="properties_flags">
93
 
</colgroup>
94
 
<tbody><tr>
95
 
<td class="property_type">
96
 
<a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a> *</td>
97
 
<td class="property_name"><a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager--connection" title="The “connection” property">connection</a></td>
98
 
<td class="property_flags">Read / Write / Construct Only</td>
99
 
</tr></tbody>
100
 
</table></div>
101
 
</div>
102
 
<a name="TpSimplePasswordManager"></a><div class="refsect1">
103
 
<a name="telepathy-glib-simple-password-manager.other"></a><h2>Types and Values</h2>
104
 
<div class="informaltable"><table width="100%" border="0">
105
 
<colgroup>
106
 
<col width="150px" class="name">
107
 
<col class="description">
108
 
</colgroup>
109
 
<tbody><tr>
110
 
<td class="datatype_keyword">struct</td>
111
 
<td class="function_name"><a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager-struct" title="struct TpSimplePasswordManager">TpSimplePasswordManager</a></td>
112
 
</tr></tbody>
113
 
</table></div>
 
44
<div class="refsynopsisdiv">
 
45
<a name="telepathy-glib-simple-password-manager.synopsis"></a><h2>Synopsis</h2>
 
46
<a name="TpSimplePasswordManager"></a><pre class="synopsis">
 
47
#include &lt;telepathy-glib/telepathy-glib.h&gt;
 
48
 
 
49
                    <a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager-struct" title="TpSimplePasswordManager">TpSimplePasswordManager</a>;
 
50
<a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="returnvalue">TpSimplePasswordManager</span></a> * <a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-new" title="tp_simple_password_manager_new ()">tp_simple_password_manager_new</a>
 
51
                                                        (<em class="parameter"><code><a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a> *connection</code></em>);
 
52
 
 
53
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-async" title="tp_simple_password_manager_prompt_async ()">tp_simple_password_manager_prompt_async</a>
 
54
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a> *self</code></em>,
 
55
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
 
56
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
 
57
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Strings.html#GString"><span class="returnvalue">GString</span></a> *     <a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-finish" title="tp_simple_password_manager_prompt_finish ()">tp_simple_password_manager_prompt_finish</a>
 
58
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a> *self</code></em>,
 
59
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
 
60
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
 
61
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-for-channel-async" title="tp_simple_password_manager_prompt_for_channel_async ()">tp_simple_password_manager_prompt_for_channel_async</a>
 
62
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a> *self</code></em>,
 
63
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel"><span class="type">TpBasePasswordChannel</span></a> *channel</code></em>,
 
64
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
 
65
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
 
66
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Strings.html#GString"><span class="returnvalue">GString</span></a> *     <a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-for-channel-finish" title="tp_simple_password_manager_prompt_for_channel_finish ()">tp_simple_password_manager_prompt_for_channel_finish</a>
 
67
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a> *self</code></em>,
 
68
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
 
69
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel"><span class="type">TpBasePasswordChannel</span></a> **channel</code></em>,
 
70
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
 
71
</pre>
114
72
</div>
115
73
<div class="refsect1">
116
74
<a name="telepathy-glib-simple-password-manager.object-hierarchy"></a><h2>Object Hierarchy</h2>
117
 
<pre class="screen">    <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
118
 
    <span class="lineart">╰──</span> TpSimplePasswordManager
 
75
<pre class="synopsis">
 
76
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
77
   +----TpSimplePasswordManager
119
78
</pre>
120
79
</div>
121
80
<div class="refsect1">
125
84
 <a class="link" href="TpChannelManager.html" title="TpChannelManager">TpChannelManager</a>.</p>
126
85
</div>
127
86
<div class="refsect1">
128
 
<a name="telepathy-glib-simple-password-manager.includes"></a><h2>Includes</h2>
129
 
<pre class="synopsis">#include &lt;telepathy-glib/telepathy-glib.h&gt;
 
87
<a name="telepathy-glib-simple-password-manager.properties"></a><h2>Properties</h2>
 
88
<pre class="synopsis">
 
89
  "<a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager--connection" title='The "connection" property'>connection</a>"               <a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a>*     : Read / Write / Construct Only
130
90
</pre>
131
91
</div>
132
92
<div class="refsect1">
133
93
<a name="telepathy-glib-simple-password-manager.description"></a><h2>Description</h2>
134
 
<p>This class makes it easy to implement the X-TELEPATHY-PASSWORD SASL
 
94
<p>
 
95
This class makes it easy to implement the X-TELEPATHY-PASSWORD SASL
135
96
mechanism in a connection manger. It implements the
136
97
<a class="link" href="TpChannelManager.html" title="TpChannelManager"><span class="type">TpChannelManager</span></a> interface and pops up a ServerAuthentication
137
 
channel when <a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-async" title="tp_simple_password_manager_prompt_async ()"><code class="function">tp_simple_password_manager_prompt_async()</code></a> is called to
 
98
channel when <a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-async" title="tp_simple_password_manager_prompt_async ()"><code class="function">tp_simple_password_manager_prompt_async()</code></a> is called to
138
99
enable a channel handler to pass in the password using the
139
 
appropriate D-Bus methods.</p>
140
 
<p>This channel manager is only useful for connection managers only
 
100
appropriate D-Bus methods.
 
101
</p>
 
102
<p>
 
103
This channel manager is only useful for connection managers only
141
104
wanting to implement the X-TELEPATHY-PASSWORD SASL mechanism in
142
105
authentication channels. For connections with more SASL mechanisms,
143
106
the channel manager and channel itself should be reimplemented to
144
 
support the desired mechanisms.</p>
145
 
<p>A new <a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a> object should be created in the
 
107
support the desired mechanisms.
 
108
</p>
 
109
<p>
 
110
A new <a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a> object should be created in the
146
111
<a class="link" href="TpBaseConnection.html#TpBaseConnectionClass" title="struct TpBaseConnectionClass"><span class="type">TpBaseConnectionClass</span></a>-&gt;create_channel_managers implementation and
147
112
added to the <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> of channel managers. Then, in the
148
113
<a class="link" href="TpBaseConnection.html#TpBaseConnectionClass" title="struct TpBaseConnectionClass"><span class="type">TpBaseConnectionClass</span></a>-&gt;start_connecting implementation, once the
150
115
should check whether a password parameter was given when creating
151
116
the connection through RequestConnection. If a password is present,
152
117
the connection should go ahead and use it. If it is not present,
153
 
<a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-async" title="tp_simple_password_manager_prompt_async ()"><code class="function">tp_simple_password_manager_prompt_async()</code></a> should be called.</p>
154
 
<p>Once a password is retrieved using the server authentication
 
118
<a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-async" title="tp_simple_password_manager_prompt_async ()"><code class="function">tp_simple_password_manager_prompt_async()</code></a> should be called.
 
119
</p>
 
120
<p>
 
121
Once a password is retrieved using the server authentication
155
122
channel, or an error is occurred, the callback that was passed to
156
 
<a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-async" title="tp_simple_password_manager_prompt_async ()"><code class="function">tp_simple_password_manager_prompt_async()</code></a> is called and the
157
 
connection should call <a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-finish" title="tp_simple_password_manager_prompt_finish ()"><code class="function">tp_simple_password_manager_prompt_finish()</code></a>
 
123
<a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-async" title="tp_simple_password_manager_prompt_async ()"><code class="function">tp_simple_password_manager_prompt_async()</code></a> is called and the
 
124
connection should call <a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-finish" title="tp_simple_password_manager_prompt_finish ()"><code class="function">tp_simple_password_manager_prompt_finish()</code></a>
158
125
to get the result of the process. If the <a href="http://library.gnome.org/devel/glib/unstable/glib-Strings.html#GString"><span class="type">GString</span></a> returned from
159
126
said finish function is non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a>, the connection can then proceed
160
127
with that password, otherwise the connection must deal with the
161
 
error reached.</p>
 
128
error reached.
 
129
</p>
162
130
</div>
163
131
<div class="refsect1">
164
 
<a name="telepathy-glib-simple-password-manager.functions_details"></a><h2>Functions</h2>
165
 
<div class="refsect2">
166
 
<a name="tp-simple-password-manager-new"></a><h3>tp_simple_password_manager_new ()</h3>
167
 
<pre class="programlisting"><a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="returnvalue">TpSimplePasswordManager</span></a> *
168
 
tp_simple_password_manager_new (<em class="parameter"><code><a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a> *connection</code></em>);</pre>
169
 
<p>Creates a new simple server authentication channel manager.</p>
170
 
<div class="refsect3">
171
 
<a name="id-1.6.20.11.2.5"></a><h4>Parameters</h4>
172
 
<div class="informaltable"><table width="100%" border="0">
173
 
<colgroup>
174
 
<col width="150px" class="parameters_name">
175
 
<col class="parameters_description">
176
 
<col width="200px" class="parameters_annotations">
177
 
</colgroup>
178
 
<tbody><tr>
179
 
<td class="parameter_name"><p>connection</p></td>
180
 
<td class="parameter_description"><p>a <a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a></p></td>
181
 
<td class="parameter_annotations"> </td>
182
 
</tr></tbody>
183
 
</table></div>
184
 
</div>
185
 
<div class="refsect3">
186
 
<a name="id-1.6.20.11.2.6"></a><h4>Returns</h4>
187
 
<p> a new reference to a server authentication channel
188
 
manager.</p>
189
 
<p></p>
190
 
</div>
191
 
</div>
192
 
<hr>
193
 
<div class="refsect2">
194
 
<a name="tp-simple-password-manager-prompt-async"></a><h3>tp_simple_password_manager_prompt_async ()</h3>
195
 
<pre class="programlisting"><span class="returnvalue">void</span>
196
 
tp_simple_password_manager_prompt_async
197
 
                               (<em class="parameter"><code><a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a> *self</code></em>,
198
 
                                <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
199
 
                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
200
 
<p>Pops up a new server authentication channel and handles the
201
 
X-TELEPATHY-PASSWORD mechanism to obtain a password for the
202
 
connection.</p>
203
 
<p>When the operation is finished, <em class="parameter"><code>callback</code></em>
204
 
 will be called. You must then
205
 
call <a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-finish" title="tp_simple_password_manager_prompt_finish ()"><code class="function">tp_simple_password_manager_prompt_finish()</code></a> to get the
206
 
result of the request.</p>
207
 
<div class="refsect3">
208
 
<a name="id-1.6.20.11.3.6"></a><h4>Parameters</h4>
209
 
<div class="informaltable"><table width="100%" border="0">
210
 
<colgroup>
211
 
<col width="150px" class="parameters_name">
212
 
<col class="parameters_description">
213
 
<col width="200px" class="parameters_annotations">
214
 
</colgroup>
215
 
<tbody>
216
 
<tr>
217
 
<td class="parameter_name"><p>self</p></td>
218
 
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a></p></td>
219
 
<td class="parameter_annotations"> </td>
220
 
</tr>
221
 
<tr>
222
 
<td class="parameter_name"><p>callback</p></td>
223
 
<td class="parameter_description"><p>a callback to call when the request is satisfied</p></td>
224
 
<td class="parameter_annotations"> </td>
225
 
</tr>
226
 
<tr>
227
 
<td class="parameter_name"><p>user_data</p></td>
228
 
<td class="parameter_description"><p>data to pass to <em class="parameter"><code>callback</code></em>
229
 
</p></td>
230
 
<td class="parameter_annotations"> </td>
231
 
</tr>
232
 
</tbody>
233
 
</table></div>
234
 
</div>
235
 
<p class="since">Since 0.13.8</p>
236
 
</div>
237
 
<hr>
238
 
<div class="refsect2">
239
 
<a name="tp-simple-password-manager-prompt-finish"></a><h3>tp_simple_password_manager_prompt_finish ()</h3>
240
 
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Strings.html#GString"><span class="returnvalue">GString</span></a> *
241
 
tp_simple_password_manager_prompt_finish
242
 
                               (<em class="parameter"><code><a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a> *self</code></em>,
243
 
                                <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
244
 
                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
245
 
<p>Retrieve the value of the request begun with
246
 
<a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-async" title="tp_simple_password_manager_prompt_async ()"><code class="function">tp_simple_password_manager_prompt_async()</code></a>.</p>
247
 
<div class="refsect3">
248
 
<a name="id-1.6.20.11.4.5"></a><h4>Parameters</h4>
249
 
<div class="informaltable"><table width="100%" border="0">
250
 
<colgroup>
251
 
<col width="150px" class="parameters_name">
252
 
<col class="parameters_description">
253
 
<col width="200px" class="parameters_annotations">
254
 
</colgroup>
255
 
<tbody>
256
 
<tr>
257
 
<td class="parameter_name"><p>self</p></td>
258
 
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a></p></td>
259
 
<td class="parameter_annotations"> </td>
260
 
</tr>
261
 
<tr>
262
 
<td class="parameter_name"><p>result</p></td>
263
 
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a></p></td>
264
 
<td class="parameter_annotations"> </td>
265
 
</tr>
266
 
<tr>
267
 
<td class="parameter_name"><p>error</p></td>
268
 
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</p></td>
269
 
<td class="parameter_annotations"> </td>
270
 
</tr>
271
 
</tbody>
272
 
</table></div>
273
 
</div>
274
 
<div class="refsect3">
275
 
<a name="id-1.6.20.11.4.6"></a><h4>Returns</h4>
276
 
<p> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Strings.html#GString"><span class="type">GString</span></a> with the password (or byte-blob)
277
 
retrieved by <em class="parameter"><code>manager</code></em>
278
 
. </p>
279
 
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
280
 
</div>
281
 
<p class="since">Since 0.13.8</p>
282
 
</div>
283
 
<hr>
284
 
<div class="refsect2">
285
 
<a name="tp-simple-password-manager-prompt-for-channel-async"></a><h3>tp_simple_password_manager_prompt_for_channel_async ()</h3>
286
 
<pre class="programlisting"><span class="returnvalue">void</span>
287
 
tp_simple_password_manager_prompt_for_channel_async
288
 
                               (<em class="parameter"><code><a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a> *self</code></em>,
289
 
                                <em class="parameter"><code><a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel"><span class="type">TpBasePasswordChannel</span></a> *channel</code></em>,
290
 
                                <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
291
 
                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
292
 
<p>Pops up a new server authentication channel and handles the
293
 
X-TELEPATHY-PASSWORD mechanism to obtain a password for the
294
 
connection.</p>
295
 
<p>When the operation is finished, <em class="parameter"><code>callback</code></em>
296
 
 will be called. You must then
297
 
call <a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-for-channel-finish" title="tp_simple_password_manager_prompt_for_channel_finish ()"><code class="function">tp_simple_password_manager_prompt_for_channel_finish()</code></a> to get the
298
 
result of the request.</p>
299
 
<p>Most of the time, <a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-async" title="tp_simple_password_manager_prompt_async ()"><code class="function">tp_simple_password_manager_prompt_async()</code></a> should be used
 
132
<a name="telepathy-glib-simple-password-manager.details"></a><h2>Details</h2>
 
133
<div class="refsect2">
 
134
<a name="TpSimplePasswordManager-struct"></a><h3>TpSimplePasswordManager</h3>
 
135
<pre class="programlisting">typedef struct _TpSimplePasswordManager TpSimplePasswordManager;</pre>
 
136
<p>
 
137
A helper channel manager to manage X-TELEPATHY-PASSWORD
 
138
ServerAuthentication channels.
 
139
</p>
 
140
<p class="since">Since 0.13.8</p>
 
141
</div>
 
142
<hr>
 
143
<div class="refsect2">
 
144
<a name="tp-simple-password-manager-new"></a><h3>tp_simple_password_manager_new ()</h3>
 
145
<pre class="programlisting"><a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="returnvalue">TpSimplePasswordManager</span></a> * tp_simple_password_manager_new
 
146
                                                        (<em class="parameter"><code><a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a> *connection</code></em>);</pre>
 
147
<p>
 
148
Creates a new simple server authentication channel manager.
 
149
</p>
 
150
<div class="variablelist"><table border="0" class="variablelist">
 
151
<colgroup>
 
152
<col align="left" valign="top">
 
153
<col>
 
154
</colgroup>
 
155
<tbody>
 
156
<tr>
 
157
<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
 
158
<td>a <a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a>
 
159
</td>
 
160
</tr>
 
161
<tr>
 
162
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
163
<td>a new reference to a server authentication channel
 
164
manager.</td>
 
165
</tr>
 
166
</tbody>
 
167
</table></div>
 
168
</div>
 
169
<hr>
 
170
<div class="refsect2">
 
171
<a name="tp-simple-password-manager-prompt-async"></a><h3>tp_simple_password_manager_prompt_async ()</h3>
 
172
<pre class="programlisting"><span class="returnvalue">void</span>                tp_simple_password_manager_prompt_async
 
173
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a> *self</code></em>,
 
174
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
 
175
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 
176
<p>
 
177
Pops up a new server authentication channel and handles the
 
178
X-TELEPATHY-PASSWORD mechanism to obtain a password for the
 
179
connection.
 
180
</p>
 
181
<p>
 
182
When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You must then
 
183
call <a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-finish" title="tp_simple_password_manager_prompt_finish ()"><code class="function">tp_simple_password_manager_prompt_finish()</code></a> to get the
 
184
result of the request.
 
185
</p>
 
186
<div class="variablelist"><table border="0" class="variablelist">
 
187
<colgroup>
 
188
<col align="left" valign="top">
 
189
<col>
 
190
</colgroup>
 
191
<tbody>
 
192
<tr>
 
193
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
194
<td>a <a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a>
 
195
</td>
 
196
</tr>
 
197
<tr>
 
198
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
 
199
<td>a callback to call when the request is satisfied</td>
 
200
</tr>
 
201
<tr>
 
202
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 
203
<td>data to pass to <em class="parameter"><code>callback</code></em>
 
204
</td>
 
205
</tr>
 
206
</tbody>
 
207
</table></div>
 
208
<p class="since">Since 0.13.8</p>
 
209
</div>
 
210
<hr>
 
211
<div class="refsect2">
 
212
<a name="tp-simple-password-manager-prompt-finish"></a><h3>tp_simple_password_manager_prompt_finish ()</h3>
 
213
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Strings.html#GString"><span class="returnvalue">GString</span></a> *     tp_simple_password_manager_prompt_finish
 
214
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a> *self</code></em>,
 
215
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
 
216
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 
217
<p>
 
218
Retrieve the value of the request begun with
 
219
<a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-async" title="tp_simple_password_manager_prompt_async ()"><code class="function">tp_simple_password_manager_prompt_async()</code></a>.
 
220
</p>
 
221
<div class="variablelist"><table border="0" class="variablelist">
 
222
<colgroup>
 
223
<col align="left" valign="top">
 
224
<col>
 
225
</colgroup>
 
226
<tbody>
 
227
<tr>
 
228
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
229
<td>a <a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a>
 
230
</td>
 
231
</tr>
 
232
<tr>
 
233
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
 
234
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
 
235
</td>
 
236
</tr>
 
237
<tr>
 
238
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 
239
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</td>
 
240
</tr>
 
241
<tr>
 
242
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
243
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Strings.html#GString"><span class="type">GString</span></a> with the password (or byte-blob)
 
244
retrieved by <em class="parameter"><code>manager</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
245
</td>
 
246
</tr>
 
247
</tbody>
 
248
</table></div>
 
249
<p class="since">Since 0.13.8</p>
 
250
</div>
 
251
<hr>
 
252
<div class="refsect2">
 
253
<a name="tp-simple-password-manager-prompt-for-channel-async"></a><h3>tp_simple_password_manager_prompt_for_channel_async ()</h3>
 
254
<pre class="programlisting"><span class="returnvalue">void</span>                tp_simple_password_manager_prompt_for_channel_async
 
255
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a> *self</code></em>,
 
256
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel"><span class="type">TpBasePasswordChannel</span></a> *channel</code></em>,
 
257
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
 
258
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 
259
<p>
 
260
Pops up a new server authentication channel and handles the
 
261
X-TELEPATHY-PASSWORD mechanism to obtain a password for the
 
262
connection.
 
263
</p>
 
264
<p>
 
265
When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You must then
 
266
call <a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-for-channel-finish" title="tp_simple_password_manager_prompt_for_channel_finish ()"><code class="function">tp_simple_password_manager_prompt_for_channel_finish()</code></a> to get the
 
267
result of the request.
 
268
</p>
 
269
<p>
 
270
Most of the time, <a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-async" title="tp_simple_password_manager_prompt_async ()"><code class="function">tp_simple_password_manager_prompt_async()</code></a> should be used
300
271
instead.  This function enables applications to provide custom channels
301
272
instead of letting the password manager handle all of the channel details
302
273
automatically.  This may be useful if your SASL channel needs to implement
303
 
additional interfaces (such as Channel.Interface.CredentialsStorage)</p>
304
 
<div class="refsect3">
305
 
<a name="id-1.6.20.11.5.7"></a><h4>Parameters</h4>
306
 
<div class="informaltable"><table width="100%" border="0">
 
274
additional interfaces (such as Channel.Interface.CredentialsStorage)
 
275
</p>
 
276
<div class="variablelist"><table border="0" class="variablelist">
307
277
<colgroup>
308
 
<col width="150px" class="parameters_name">
309
 
<col class="parameters_description">
310
 
<col width="200px" class="parameters_annotations">
 
278
<col align="left" valign="top">
 
279
<col>
311
280
</colgroup>
312
281
<tbody>
313
282
<tr>
314
 
<td class="parameter_name"><p>self</p></td>
315
 
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a></p></td>
316
 
<td class="parameter_annotations"> </td>
317
 
</tr>
318
 
<tr>
319
 
<td class="parameter_name"><p>channel</p></td>
320
 
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel"><span class="type">TpBasePasswordChannel</span></a></p></td>
321
 
<td class="parameter_annotations"> </td>
322
 
</tr>
323
 
<tr>
324
 
<td class="parameter_name"><p>callback</p></td>
325
 
<td class="parameter_description"><p>a callback to call when the request is satisfied</p></td>
326
 
<td class="parameter_annotations"> </td>
327
 
</tr>
328
 
<tr>
329
 
<td class="parameter_name"><p>user_data</p></td>
330
 
<td class="parameter_description"><p>data to pass to <em class="parameter"><code>callback</code></em>
331
 
</p></td>
332
 
<td class="parameter_annotations"> </td>
 
283
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
284
<td>a <a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a>
 
285
</td>
 
286
</tr>
 
287
<tr>
 
288
<td><p><span class="term"><em class="parameter"><code>channel</code></em> :</span></p></td>
 
289
<td>a <a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel"><span class="type">TpBasePasswordChannel</span></a>
 
290
</td>
 
291
</tr>
 
292
<tr>
 
293
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
 
294
<td>a callback to call when the request is satisfied</td>
 
295
</tr>
 
296
<tr>
 
297
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 
298
<td>data to pass to <em class="parameter"><code>callback</code></em>
 
299
</td>
333
300
</tr>
334
301
</tbody>
335
302
</table></div>
336
 
</div>
337
303
<p class="since">Since 0.13.15</p>
338
304
</div>
339
305
<hr>
340
306
<div class="refsect2">
341
 
<a name="tp-simple-password-manager-prompt-for-channel-finish"></a><h3>tp_simple_password_manager_prompt_for_channel_finish ()</h3>
342
 
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Strings.html#GString"><span class="returnvalue">GString</span></a> *
343
 
tp_simple_password_manager_prompt_for_channel_finish
344
 
                               (<em class="parameter"><code><a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a> *self</code></em>,
345
 
                                <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
346
 
                                <em class="parameter"><code><a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel"><span class="type">TpBasePasswordChannel</span></a> **channel</code></em>,
347
 
                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
348
 
<p>Retrieve the value of the request begun with
349
 
<a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-for-channel-async" title="tp_simple_password_manager_prompt_for_channel_async ()"><code class="function">tp_simple_password_manager_prompt_for_channel_async()</code></a>.</p>
350
 
<div class="refsect3">
351
 
<a name="id-1.6.20.11.6.5"></a><h4>Parameters</h4>
352
 
<div class="informaltable"><table width="100%" border="0">
 
307
<a name="tp-simple-password-manager-prompt-for-channel-finish"></a><h3>tp_simple_password_manager_prompt_for_channel_finish ()</h3>
 
308
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Strings.html#GString"><span class="returnvalue">GString</span></a> *     tp_simple_password_manager_prompt_for_channel_finish
 
309
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a> *self</code></em>,
 
310
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
 
311
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-base-password-channel.html#TpBasePasswordChannel"><span class="type">TpBasePasswordChannel</span></a> **channel</code></em>,
 
312
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 
313
<p>
 
314
Retrieve the value of the request begun with
 
315
<a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-for-channel-async" title="tp_simple_password_manager_prompt_for_channel_async ()"><code class="function">tp_simple_password_manager_prompt_for_channel_async()</code></a>.
 
316
</p>
 
317
<div class="variablelist"><table border="0" class="variablelist">
353
318
<colgroup>
354
 
<col width="150px" class="parameters_name">
355
 
<col class="parameters_description">
356
 
<col width="200px" class="parameters_annotations">
 
319
<col align="left" valign="top">
 
320
<col>
357
321
</colgroup>
358
322
<tbody>
359
323
<tr>
360
 
<td class="parameter_name"><p>self</p></td>
361
 
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a></p></td>
362
 
<td class="parameter_annotations"> </td>
363
 
</tr>
364
 
<tr>
365
 
<td class="parameter_name"><p>result</p></td>
366
 
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a></p></td>
367
 
<td class="parameter_annotations"> </td>
368
 
</tr>
369
 
<tr>
370
 
<td class="parameter_name"><p>channel</p></td>
371
 
<td class="parameter_description"><p> an output location to retrieve the custom
 
324
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
325
<td>a <a class="link" href="telepathy-glib-simple-password-manager.html#TpSimplePasswordManager"><span class="type">TpSimplePasswordManager</span></a>
 
326
</td>
 
327
</tr>
 
328
<tr>
 
329
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
 
330
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
 
331
</td>
 
332
</tr>
 
333
<tr>
 
334
<td><p><span class="term"><em class="parameter"><code>channel</code></em> :</span></p></td>
 
335
<td>an output location to retrieve the custom
372
336
password channel that was passed to
373
 
<a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-for-channel-async" title="tp_simple_password_manager_prompt_for_channel_async ()"><code class="function">tp_simple_password_manager_prompt_for_channel_async()</code></a>. </p></td>
374
 
<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
375
 
</tr>
376
 
<tr>
377
 
<td class="parameter_name"><p>error</p></td>
378
 
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</p></td>
379
 
<td class="parameter_annotations"> </td>
 
337
<a class="link" href="telepathy-glib-simple-password-manager.html#tp-simple-password-manager-prompt-for-channel-async" title="tp_simple_password_manager_prompt_for_channel_async ()"><code class="function">tp_simple_password_manager_prompt_for_channel_async()</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
338
</td>
 
339
</tr>
 
340
<tr>
 
341
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 
342
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</td>
 
343
</tr>
 
344
<tr>
 
345
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
346
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Strings.html#GString"><span class="type">GString</span></a> with the password (or byte-blob)
 
347
retrieved by <em class="parameter"><code>manager</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
348
</td>
380
349
</tr>
381
350
</tbody>
382
351
</table></div>
383
 
</div>
384
 
<div class="refsect3">
385
 
<a name="id-1.6.20.11.6.6"></a><h4>Returns</h4>
386
 
<p> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Strings.html#GString"><span class="type">GString</span></a> with the password (or byte-blob)
387
 
retrieved by <em class="parameter"><code>manager</code></em>
388
 
. </p>
389
 
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
390
 
</div>
391
352
<p class="since">Since 0.13.15</p>
392
353
</div>
393
354
</div>
394
355
<div class="refsect1">
395
 
<a name="telepathy-glib-simple-password-manager.other_details"></a><h2>Types and Values</h2>
396
 
<div class="refsect2">
397
 
<a name="TpSimplePasswordManager-struct"></a><h3>struct TpSimplePasswordManager</h3>
398
 
<pre class="programlisting">struct TpSimplePasswordManager;</pre>
399
 
<p>A helper channel manager to manage X-TELEPATHY-PASSWORD
400
 
ServerAuthentication channels.</p>
401
 
<p class="since">Since 0.13.8</p>
402
 
</div>
403
 
</div>
404
 
<div class="refsect1">
405
356
<a name="telepathy-glib-simple-password-manager.property-details"></a><h2>Property Details</h2>
406
357
<div class="refsect2">
407
 
<a name="TpSimplePasswordManager--connection"></a><h3>The <code class="literal">“connection”</code> property</h3>
408
 
<pre class="programlisting">  “connection”               <a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a> *</pre>
 
358
<a name="TpSimplePasswordManager--connection"></a><h3>The <code class="literal">"connection"</code> property</h3>
 
359
<pre class="programlisting">  "connection"               <a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a>*     : Read / Write / Construct Only</pre>
409
360
<p>The connection object that owns this channel manager.</p>
410
 
<p>Flags: Read / Write / Construct Only</p>
411
361
</div>
412
362
</div>
413
363
</div>
414
364
<div class="footer">
415
365
<hr>
416
 
          Generated by GTK-Doc V1.20</div>
 
366
          Generated by GTK-Doc V1.19</div>
417
367
</body>
418
368
</html>
 
 
b'\\ No newline at end of file'