Update to upstream 1.0.1
[profile/ivi/gsignond.git] / docs / html / GSignondCredentials.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html>
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>gsignond API Reference Manual: GSignondCredentials</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7 <link rel="home" href="index.html" title="gsignond API Reference Manual">
8 <link rel="up" href="ch06.html" title="GSignond API for writing platform adaptation extensions">
9 <link rel="prev" href="GSignondSecretStorage.html" title="GSignondSecretStorage">
10 <link rel="next" href="ch07.html" title="Miscellaneous">
11 <meta name="generator" content="GTK-Doc V1.20 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
13 </head>
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="#GSignondCredentials.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 
19                   <a href="#GSignondCredentials.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
20 </td>
21 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
22 <td><a accesskey="u" href="ch06.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
23 <td><a accesskey="p" href="GSignondSecretStorage.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
24 <td><a accesskey="n" href="ch07.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
25 </tr></table>
26 <div class="refentry">
27 <a name="GSignondCredentials"></a><div class="titlepage"></div>
28 <div class="refnamediv"><table width="100%"><tr>
29 <td valign="top">
30 <h2><span class="refentrytitle"><a name="GSignondCredentials.top_of_page"></a>GSignondCredentials</span></h2>
31 <p>GSignondCredentials — credentials (username, password) associated with an identity</p>
32 </td>
33 <td class="gallery_image" valign="top" align="right"></td>
34 </tr></table></div>
35 <div class="refsect1">
36 <a name="GSignondCredentials.functions"></a><h2>Functions</h2>
37 <div class="informaltable"><table width="100%" border="0">
38 <colgroup>
39 <col width="150px" class="functions_return">
40 <col class="functions_name">
41 </colgroup>
42 <tbody>
43 <tr>
44 <td class="function_type">
45 <a class="link" href="GSignondCredentials.html" title="GSignondCredentials"><span class="returnvalue">GSignondCredentials</span></a> *
46 </td>
47 <td class="function_name">
48 <a class="link" href="GSignondCredentials.html#gsignond-credentials-new" title="gsignond_credentials_new ()">gsignond_credentials_new</a> <span class="c_punctuation">()</span>
49 </td>
50 </tr>
51 <tr>
52 <td class="function_type">
53 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
54 </td>
55 <td class="function_name">
56 <a class="link" href="GSignondCredentials.html#gsignond-credentials-set-data" title="gsignond_credentials_set_data ()">gsignond_credentials_set_data</a> <span class="c_punctuation">()</span>
57 </td>
58 </tr>
59 <tr>
60 <td class="function_type">
61 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
62 </td>
63 <td class="function_name">
64 <a class="link" href="GSignondCredentials.html#gsignond-credentials-set-id" title="gsignond_credentials_set_id ()">gsignond_credentials_set_id</a> <span class="c_punctuation">()</span>
65 </td>
66 </tr>
67 <tr>
68 <td class="function_type">
69 <span class="returnvalue">guint32</span>
70 </td>
71 <td class="function_name">
72 <a class="link" href="GSignondCredentials.html#gsignond-credentials-get-id" title="gsignond_credentials_get_id ()">gsignond_credentials_get_id</a> <span class="c_punctuation">()</span>
73 </td>
74 </tr>
75 <tr>
76 <td class="function_type">
77 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
78 </td>
79 <td class="function_name">
80 <a class="link" href="GSignondCredentials.html#gsignond-credentials-set-username" title="gsignond_credentials_set_username ()">gsignond_credentials_set_username</a> <span class="c_punctuation">()</span>
81 </td>
82 </tr>
83 <tr>
84 <td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
85 </td>
86 <td class="function_name">
87 <a class="link" href="GSignondCredentials.html#gsignond-credentials-get-username" title="gsignond_credentials_get_username ()">gsignond_credentials_get_username</a> <span class="c_punctuation">()</span>
88 </td>
89 </tr>
90 <tr>
91 <td class="function_type">
92 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
93 </td>
94 <td class="function_name">
95 <a class="link" href="GSignondCredentials.html#gsignond-credentials-set-password" title="gsignond_credentials_set_password ()">gsignond_credentials_set_password</a> <span class="c_punctuation">()</span>
96 </td>
97 </tr>
98 <tr>
99 <td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
100 </td>
101 <td class="function_name">
102 <a class="link" href="GSignondCredentials.html#gsignond-credentials-get-password" title="gsignond_credentials_get_password ()">gsignond_credentials_get_password</a> <span class="c_punctuation">()</span>
103 </td>
104 </tr>
105 <tr>
106 <td class="function_type">
107 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
108 </td>
109 <td class="function_name">
110 <a class="link" href="GSignondCredentials.html#gsignond-credentials-equal" title="gsignond_credentials_equal ()">gsignond_credentials_equal</a> <span class="c_punctuation">()</span>
111 </td>
112 </tr>
113 </tbody>
114 </table></div>
115 </div>
116 <div class="refsect1">
117 <a name="GSignondCredentials.object-hierarchy"></a><h2>Object Hierarchy</h2>
118 <pre class="screen">    <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
119     <span class="lineart">╰──</span> GSignondCredentials
120 </pre>
121 </div>
122 <div class="refsect1">
123 <a name="GSignondCredentials.includes"></a><h2>Includes</h2>
124 <pre class="synopsis">#include &lt;gsignond/gsignond-credentials.h&gt;
125 </pre>
126 </div>
127 <div class="refsect1">
128 <a name="GSignondCredentials.description"></a><h2>Description</h2>
129 <p><a class="link" href="GSignondCredentials.html" title="GSignondCredentials"><span class="type">GSignondCredentials</span></a> hold a username, password, and identity id, associated
130 with an identity. This information in stored in secret storage using 
131 <a class="link" href="GSignondSecretStorage.html" title="GSignondSecretStorage"><span class="type">GSignondSecretStorage</span></a>.</p>
132 </div>
133 <div class="refsect1">
134 <a name="GSignondCredentials.functions_details"></a><h2>Functions</h2>
135 <div class="refsect2">
136 <a name="gsignond-credentials-new"></a><h3>gsignond_credentials_new ()</h3>
137 <pre class="programlisting"><a class="link" href="GSignondCredentials.html" title="GSignondCredentials"><span class="returnvalue">GSignondCredentials</span></a> *
138 gsignond_credentials_new ();</pre>
139 <p>Creates a new empty <a class="link" href="GSignondCredentials.html" title="GSignondCredentials"><span class="type">GSignondCredentials</span></a> object</p>
140 <div class="refsect3">
141 <a name="id-1.7.7.7.2.5"></a><h4>Returns</h4>
142 <p> the <a class="link" href="GSignondCredentials.html" title="GSignondCredentials"><span class="type">GSignondCredentials</span></a> object. </p>
143 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
144 </div>
145 </div>
146 <hr>
147 <div class="refsect2">
148 <a name="gsignond-credentials-set-data"></a><h3>gsignond_credentials_set_data ()</h3>
149 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
150 gsignond_credentials_set_data (<em class="parameter"><code><a class="link" href="GSignondCredentials.html" title="GSignondCredentials"><span class="type">GSignondCredentials</span></a> *self</code></em>,
151                                <em class="parameter"><code>const <span class="type">guint32</span> id</code></em>,
152                                <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *username</code></em>,
153                                <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *password</code></em>);</pre>
154 <p>Sets the data of the <a class="link" href="GSignondCredentials.html" title="GSignondCredentials"><span class="type">GSignondCredentials</span></a>.</p>
155 <div class="refsect3">
156 <a name="id-1.7.7.7.3.5"></a><h4>Parameters</h4>
157 <div class="informaltable"><table width="100%" border="0">
158 <colgroup>
159 <col width="150px" class="parameters_name">
160 <col class="parameters_description">
161 <col width="200px" class="parameters_annotations">
162 </colgroup>
163 <tbody>
164 <tr>
165 <td class="parameter_name"><p>self</p></td>
166 <td class="parameter_description"><p>the object whose data is to be set.</p></td>
167 <td class="parameter_annotations"> </td>
168 </tr>
169 <tr>
170 <td class="parameter_name"><p>id</p></td>
171 <td class="parameter_description"><p>the identity id associated with the credentials.</p></td>
172 <td class="parameter_annotations"> </td>
173 </tr>
174 <tr>
175 <td class="parameter_name"><p>username</p></td>
176 <td class="parameter_description"><p> the username. </p></td>
177 <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>
178 </tr>
179 <tr>
180 <td class="parameter_name"><p>password</p></td>
181 <td class="parameter_description"><p>the password. </p></td>
182 <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>
183 </tr>
184 </tbody>
185 </table></div>
186 </div>
187 <div class="refsect3">
188 <a name="id-1.7.7.7.3.6"></a><h4>Returns</h4>
189 <p> TRUE if successful, FALSE otherwise.</p>
190 <p></p>
191 </div>
192 </div>
193 <hr>
194 <div class="refsect2">
195 <a name="gsignond-credentials-set-id"></a><h3>gsignond_credentials_set_id ()</h3>
196 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
197 gsignond_credentials_set_id (<em class="parameter"><code><a class="link" href="GSignondCredentials.html" title="GSignondCredentials"><span class="type">GSignondCredentials</span></a> *self</code></em>,
198                              <em class="parameter"><code>const <span class="type">guint32</span> id</code></em>);</pre>
199 <p>Sets the identity id of the <a class="link" href="GSignondCredentials.html" title="GSignondCredentials"><span class="type">GSignondCredentials</span></a> object</p>
200 <div class="refsect3">
201 <a name="id-1.7.7.7.4.5"></a><h4>Parameters</h4>
202 <div class="informaltable"><table width="100%" border="0">
203 <colgroup>
204 <col width="150px" class="parameters_name">
205 <col class="parameters_description">
206 <col width="200px" class="parameters_annotations">
207 </colgroup>
208 <tbody>
209 <tr>
210 <td class="parameter_name"><p>self</p></td>
211 <td class="parameter_description"><p>the object whose id is to be set.</p></td>
212 <td class="parameter_annotations"> </td>
213 </tr>
214 <tr>
215 <td class="parameter_name"><p>id</p></td>
216 <td class="parameter_description"><p>the id.</p></td>
217 <td class="parameter_annotations"> </td>
218 </tr>
219 </tbody>
220 </table></div>
221 </div>
222 <div class="refsect3">
223 <a name="id-1.7.7.7.4.6"></a><h4>Returns</h4>
224 <p> TRUE if successful, FALSE otherwise.</p>
225 <p></p>
226 </div>
227 </div>
228 <hr>
229 <div class="refsect2">
230 <a name="gsignond-credentials-get-id"></a><h3>gsignond_credentials_get_id ()</h3>
231 <pre class="programlisting"><span class="returnvalue">guint32</span>
232 gsignond_credentials_get_id (<em class="parameter"><code><a class="link" href="GSignondCredentials.html" title="GSignondCredentials"><span class="type">GSignondCredentials</span></a> *self</code></em>);</pre>
233 <p>Gets the identity id</p>
234 <div class="refsect3">
235 <a name="id-1.7.7.7.5.5"></a><h4>Parameters</h4>
236 <div class="informaltable"><table width="100%" border="0">
237 <colgroup>
238 <col width="150px" class="parameters_name">
239 <col class="parameters_description">
240 <col width="200px" class="parameters_annotations">
241 </colgroup>
242 <tbody><tr>
243 <td class="parameter_name"><p>self</p></td>
244 <td class="parameter_description"><p>the object whose id is to be set.</p></td>
245 <td class="parameter_annotations"> </td>
246 </tr></tbody>
247 </table></div>
248 </div>
249 <div class="refsect3">
250 <a name="id-1.7.7.7.5.6"></a><h4>Returns</h4>
251 <p> the id</p>
252 <p></p>
253 </div>
254 </div>
255 <hr>
256 <div class="refsect2">
257 <a name="gsignond-credentials-set-username"></a><h3>gsignond_credentials_set_username ()</h3>
258 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
259 gsignond_credentials_set_username (<em class="parameter"><code><a class="link" href="GSignondCredentials.html" title="GSignondCredentials"><span class="type">GSignondCredentials</span></a> *self</code></em>,
260                                    <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *username</code></em>);</pre>
261 <p>Sets the username of the GSignondCredentials object</p>
262 <div class="refsect3">
263 <a name="id-1.7.7.7.6.5"></a><h4>Parameters</h4>
264 <div class="informaltable"><table width="100%" border="0">
265 <colgroup>
266 <col width="150px" class="parameters_name">
267 <col class="parameters_description">
268 <col width="200px" class="parameters_annotations">
269 </colgroup>
270 <tbody>
271 <tr>
272 <td class="parameter_name"><p>self</p></td>
273 <td class="parameter_description"><p>the object whose username is to be set.</p></td>
274 <td class="parameter_annotations"> </td>
275 </tr>
276 <tr>
277 <td class="parameter_name"><p>username</p></td>
278 <td class="parameter_description"><p> the username. </p></td>
279 <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>
280 </tr>
281 </tbody>
282 </table></div>
283 </div>
284 <div class="refsect3">
285 <a name="id-1.7.7.7.6.6"></a><h4>Returns</h4>
286 <p> TRUE if successful, FALSE otherwise.</p>
287 <p></p>
288 </div>
289 </div>
290 <hr>
291 <div class="refsect2">
292 <a name="gsignond-credentials-get-username"></a><h3>gsignond_credentials_get_username ()</h3>
293 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
294 gsignond_credentials_get_username (<em class="parameter"><code><a class="link" href="GSignondCredentials.html" title="GSignondCredentials"><span class="type">GSignondCredentials</span></a> *self</code></em>);</pre>
295 <p>Gets the username of the <a class="link" href="GSignondCredentials.html" title="GSignondCredentials"><span class="type">GSignondCredentials</span></a> object</p>
296 <div class="refsect3">
297 <a name="id-1.7.7.7.7.5"></a><h4>Parameters</h4>
298 <div class="informaltable"><table width="100%" border="0">
299 <colgroup>
300 <col width="150px" class="parameters_name">
301 <col class="parameters_description">
302 <col width="200px" class="parameters_annotations">
303 </colgroup>
304 <tbody><tr>
305 <td class="parameter_name"><p>self</p></td>
306 <td class="parameter_description"><p>the object whose username is to be set.</p></td>
307 <td class="parameter_annotations"> </td>
308 </tr></tbody>
309 </table></div>
310 </div>
311 <div class="refsect3">
312 <a name="id-1.7.7.7.7.6"></a><h4>Returns</h4>
313 <p> the username if the object is valid, NULL otherwise. </p>
314 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
315 </div>
316 </div>
317 <hr>
318 <div class="refsect2">
319 <a name="gsignond-credentials-set-password"></a><h3>gsignond_credentials_set_password ()</h3>
320 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
321 gsignond_credentials_set_password (<em class="parameter"><code><a class="link" href="GSignondCredentials.html" title="GSignondCredentials"><span class="type">GSignondCredentials</span></a> *self</code></em>,
322                                    <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *password</code></em>);</pre>
323 <p>Sets the password of the GSignondCredentials object</p>
324 <div class="refsect3">
325 <a name="id-1.7.7.7.8.5"></a><h4>Parameters</h4>
326 <div class="informaltable"><table width="100%" border="0">
327 <colgroup>
328 <col width="150px" class="parameters_name">
329 <col class="parameters_description">
330 <col width="200px" class="parameters_annotations">
331 </colgroup>
332 <tbody>
333 <tr>
334 <td class="parameter_name"><p>self</p></td>
335 <td class="parameter_description"><p>the object whose password is to be set.</p></td>
336 <td class="parameter_annotations"> </td>
337 </tr>
338 <tr>
339 <td class="parameter_name"><p>password</p></td>
340 <td class="parameter_description"><p> the password. </p></td>
341 <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>
342 </tr>
343 </tbody>
344 </table></div>
345 </div>
346 <div class="refsect3">
347 <a name="id-1.7.7.7.8.6"></a><h4>Returns</h4>
348 <p> TRUE if successful, FALSE otherwise.</p>
349 <p></p>
350 </div>
351 </div>
352 <hr>
353 <div class="refsect2">
354 <a name="gsignond-credentials-get-password"></a><h3>gsignond_credentials_get_password ()</h3>
355 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
356 gsignond_credentials_get_password (<em class="parameter"><code><a class="link" href="GSignondCredentials.html" title="GSignondCredentials"><span class="type">GSignondCredentials</span></a> *self</code></em>);</pre>
357 <p>Gets the password from the <a class="link" href="GSignondCredentials.html" title="GSignondCredentials"><span class="type">GSignondCredentials</span></a> object</p>
358 <div class="refsect3">
359 <a name="id-1.7.7.7.9.5"></a><h4>Parameters</h4>
360 <div class="informaltable"><table width="100%" border="0">
361 <colgroup>
362 <col width="150px" class="parameters_name">
363 <col class="parameters_description">
364 <col width="200px" class="parameters_annotations">
365 </colgroup>
366 <tbody><tr>
367 <td class="parameter_name"><p>self</p></td>
368 <td class="parameter_description"><p>the object whose password is to be set.</p></td>
369 <td class="parameter_annotations"> </td>
370 </tr></tbody>
371 </table></div>
372 </div>
373 <div class="refsect3">
374 <a name="id-1.7.7.7.9.6"></a><h4>Returns</h4>
375 <p> the password if the object is valid, NULL otherwise. </p>
376 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
377 </div>
378 </div>
379 <hr>
380 <div class="refsect2">
381 <a name="gsignond-credentials-equal"></a><h3>gsignond_credentials_equal ()</h3>
382 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
383 gsignond_credentials_equal (<em class="parameter"><code><a class="link" href="GSignondCredentials.html" title="GSignondCredentials"><span class="type">GSignondCredentials</span></a> *one</code></em>,
384                             <em class="parameter"><code><a class="link" href="GSignondCredentials.html" title="GSignondCredentials"><span class="type">GSignondCredentials</span></a> *two</code></em>);</pre>
385 <p>Compares elements of two GSignondCredentials object for equality.</p>
386 <div class="refsect3">
387 <a name="id-1.7.7.7.10.5"></a><h4>Parameters</h4>
388 <div class="informaltable"><table width="100%" border="0">
389 <colgroup>
390 <col width="150px" class="parameters_name">
391 <col class="parameters_description">
392 <col width="200px" class="parameters_annotations">
393 </colgroup>
394 <tbody>
395 <tr>
396 <td class="parameter_name"><p>one</p></td>
397 <td class="parameter_description"><p>the first credential to be compared.</p></td>
398 <td class="parameter_annotations"> </td>
399 </tr>
400 <tr>
401 <td class="parameter_name"><p>two</p></td>
402 <td class="parameter_description"><p>the second credential to be compared.</p></td>
403 <td class="parameter_annotations"> </td>
404 </tr>
405 </tbody>
406 </table></div>
407 </div>
408 <div class="refsect3">
409 <a name="id-1.7.7.7.10.6"></a><h4>Returns</h4>
410 <p> TRUE if id, username and password are same for both credential
411 objects, FALSE otherwise.</p>
412 <p></p>
413 </div>
414 </div>
415 </div>
416 <div class="refsect1">
417 <a name="GSignondCredentials.other_details"></a><h2>Types and Values</h2>
418 </div>
419 </div>
420 <div class="footer">
421 <hr>
422           Generated by GTK-Doc V1.20</div>
423 </body>
424 </html>