Update package group and some updated autogenerated files
[profile/ivi/libgsignon-glib.git] / docs / reference / html / SignonIdentityInfo.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>libgsignon-glib Reference Manual: SignonIdentityInfo</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7 <link rel="home" href="index.html" title="libgsignon-glib Reference Manual">
8 <link rel="up" href="credential-management.html" title="Credential management">
9 <link rel="prev" href="SignonIdentity.html" title="SignonIdentity">
10 <link rel="next" href="SignonSecurityContext.html" title="SignonSecurityContext">
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="#SignonIdentityInfo.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 
19                   <a href="#SignonIdentityInfo.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="credential-management.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
23 <td><a accesskey="p" href="SignonIdentity.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
24 <td><a accesskey="n" href="SignonSecurityContext.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="SignonIdentityInfo"></a><div class="titlepage"></div>
28 <div class="refnamediv"><table width="100%"><tr>
29 <td valign="top">
30 <h2><span class="refentrytitle"><a name="SignonIdentityInfo.top_of_page"></a>SignonIdentityInfo</span></h2>
31 <p>SignonIdentityInfo — data contained in a SignonIdentity.</p>
32 </td>
33 <td class="gallery_image" valign="top" align="right"></td>
34 </tr></table></div>
35 <div class="refsect1">
36 <a name="SignonIdentityInfo.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 <span class="returnvalue">void</span>
46 </td>
47 <td class="function_name">
48 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-access-control-list-append" title="signon_identity_info_access_control_list_append ()">signon_identity_info_access_control_list_append</a> <span class="c_punctuation">()</span>
49 </td>
50 </tr>
51 <tr>
52 <td class="function_type">
53 <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="returnvalue">SignonIdentityInfo</span></a> *
54 </td>
55 <td class="function_name">
56 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-copy" title="signon_identity_info_copy ()">signon_identity_info_copy</a> <span class="c_punctuation">()</span>
57 </td>
58 </tr>
59 <tr>
60 <td class="function_type">
61 <span class="returnvalue">void</span>
62 </td>
63 <td class="function_name">
64 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-free" title="signon_identity_info_free ()">signon_identity_info_free</a> <span class="c_punctuation">()</span>
65 </td>
66 </tr>
67 <tr>
68 <td class="function_type">
69 <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="returnvalue">SignonSecurityContextList</span></a> *
70 </td>
71 <td class="function_name">
72 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-get-access-control-list" title="signon_identity_info_get_access_control_list ()">signon_identity_info_get_access_control_list</a> <span class="c_punctuation">()</span>
73 </td>
74 </tr>
75 <tr>
76 <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> *
77 </td>
78 <td class="function_name">
79 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-get-caption" title="signon_identity_info_get_caption ()">signon_identity_info_get_caption</a> <span class="c_punctuation">()</span>
80 </td>
81 </tr>
82 <tr>
83 <td class="function_type">
84 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
85 </td>
86 <td class="function_name">
87 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-get-id" title="signon_identity_info_get_id ()">signon_identity_info_get_id</a> <span class="c_punctuation">()</span>
88 </td>
89 </tr>
90 <tr>
91 <td class="function_type">
92 <a class="link" href="SignonIdentityInfo.html#SignonIdentityType" title="enum SignonIdentityType"><span class="returnvalue">SignonIdentityType</span></a>
93 </td>
94 <td class="function_name">
95 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-get-identity-type" title="signon_identity_info_get_identity_type ()">signon_identity_info_get_identity_type</a> <span class="c_punctuation">()</span>
96 </td>
97 </tr>
98 <tr>
99 <td class="function_type">
100 <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> *
101 </td>
102 <td class="function_name">
103 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-get-methods" title="signon_identity_info_get_methods ()">signon_identity_info_get_methods</a> <span class="c_punctuation">()</span>
104 </td>
105 </tr>
106 <tr>
107 <td class="function_type">const <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="returnvalue">SignonSecurityContext</span></a> *
108 </td>
109 <td class="function_name">
110 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-get-owner" title="signon_identity_info_get_owner ()">signon_identity_info_get_owner</a> <span class="c_punctuation">()</span>
111 </td>
112 </tr>
113 <tr>
114 <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> * const *
115 </td>
116 <td class="function_name">
117 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-get-realms" title="signon_identity_info_get_realms ()">signon_identity_info_get_realms</a> <span class="c_punctuation">()</span>
118 </td>
119 </tr>
120 <tr>
121 <td class="function_type">
122 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
123 </td>
124 <td class="function_name">
125 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-get-storing-secret" title="signon_identity_info_get_storing_secret ()">signon_identity_info_get_storing_secret</a> <span class="c_punctuation">()</span>
126 </td>
127 </tr>
128 <tr>
129 <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> *
130 </td>
131 <td class="function_name">
132 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-get-username" title="signon_identity_info_get_username ()">signon_identity_info_get_username</a> <span class="c_punctuation">()</span>
133 </td>
134 </tr>
135 <tr>
136 <td class="function_type">
137 <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="returnvalue">SignonIdentityInfo</span></a> *
138 </td>
139 <td class="function_name">
140 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-new" title="signon_identity_info_new ()">signon_identity_info_new</a> <span class="c_punctuation">()</span>
141 </td>
142 </tr>
143 <tr>
144 <td class="function_type">
145 <span class="returnvalue">void</span>
146 </td>
147 <td class="function_name">
148 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-own-methods" title="signon_identity_info_own_methods ()">signon_identity_info_own_methods</a> <span class="c_punctuation">()</span>
149 </td>
150 </tr>
151 <tr>
152 <td class="function_type">
153 <span class="returnvalue">void</span>
154 </td>
155 <td class="function_name">
156 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-remove-method" title="signon_identity_info_remove_method ()">signon_identity_info_remove_method</a> <span class="c_punctuation">()</span>
157 </td>
158 </tr>
159 <tr>
160 <td class="function_type">
161 <span class="returnvalue">void</span>
162 </td>
163 <td class="function_name">
164 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-set-access-control-list" title="signon_identity_info_set_access_control_list ()">signon_identity_info_set_access_control_list</a> <span class="c_punctuation">()</span>
165 </td>
166 </tr>
167 <tr>
168 <td class="function_type">
169 <span class="returnvalue">void</span>
170 </td>
171 <td class="function_name">
172 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-set-caption" title="signon_identity_info_set_caption ()">signon_identity_info_set_caption</a> <span class="c_punctuation">()</span>
173 </td>
174 </tr>
175 <tr>
176 <td class="function_type">
177 <span class="returnvalue">void</span>
178 </td>
179 <td class="function_name">
180 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-set-identity-type" title="signon_identity_info_set_identity_type ()">signon_identity_info_set_identity_type</a> <span class="c_punctuation">()</span>
181 </td>
182 </tr>
183 <tr>
184 <td class="function_type">
185 <span class="returnvalue">void</span>
186 </td>
187 <td class="function_name">
188 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-set-method" title="signon_identity_info_set_method ()">signon_identity_info_set_method</a> <span class="c_punctuation">()</span>
189 </td>
190 </tr>
191 <tr>
192 <td class="function_type">
193 <span class="returnvalue">void</span>
194 </td>
195 <td class="function_name">
196 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-set-methods" title="signon_identity_info_set_methods ()">signon_identity_info_set_methods</a> <span class="c_punctuation">()</span>
197 </td>
198 </tr>
199 <tr>
200 <td class="function_type">
201 <span class="returnvalue">void</span>
202 </td>
203 <td class="function_name">
204 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-set-owner" title="signon_identity_info_set_owner ()">signon_identity_info_set_owner</a> <span class="c_punctuation">()</span>
205 </td>
206 </tr>
207 <tr>
208 <td class="function_type">
209 <span class="returnvalue">void</span>
210 </td>
211 <td class="function_name">
212 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-set-owner-from-values" title="signon_identity_info_set_owner_from_values ()">signon_identity_info_set_owner_from_values</a> <span class="c_punctuation">()</span>
213 </td>
214 </tr>
215 <tr>
216 <td class="function_type">
217 <span class="returnvalue">void</span>
218 </td>
219 <td class="function_name">
220 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-set-realms" title="signon_identity_info_set_realms ()">signon_identity_info_set_realms</a> <span class="c_punctuation">()</span>
221 </td>
222 </tr>
223 <tr>
224 <td class="function_type">
225 <span class="returnvalue">void</span>
226 </td>
227 <td class="function_name">
228 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-set-secret" title="signon_identity_info_set_secret ()">signon_identity_info_set_secret</a> <span class="c_punctuation">()</span>
229 </td>
230 </tr>
231 <tr>
232 <td class="function_type">
233 <span class="returnvalue">void</span>
234 </td>
235 <td class="function_name">
236 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-set-username" title="signon_identity_info_set_username ()">signon_identity_info_set_username</a> <span class="c_punctuation">()</span>
237 </td>
238 </tr>
239 </tbody>
240 </table></div>
241 </div>
242 <div class="refsect1">
243 <a name="SignonIdentityInfo.other"></a><h2>Types and Values</h2>
244 <div class="informaltable"><table width="100%" border="0">
245 <colgroup>
246 <col width="150px" class="name">
247 <col class="description">
248 </colgroup>
249 <tbody>
250 <tr>
251 <td class="datatype_keyword"> </td>
252 <td class="function_name"><a class="link" href="SignonIdentityInfo.html#SignonIdentityInfo-struct" title="SignonIdentityInfo">SignonIdentityInfo</a></td>
253 </tr>
254 <tr>
255 <td class="datatype_keyword">enum</td>
256 <td class="function_name"><a class="link" href="SignonIdentityInfo.html#SignonIdentityType" title="enum SignonIdentityType">SignonIdentityType</a></td>
257 </tr>
258 </tbody>
259 </table></div>
260 </div>
261 <div class="refsect1">
262 <a name="SignonIdentityInfo.object-hierarchy"></a><h2>Object Hierarchy</h2>
263 <pre class="screen">    GBoxed
264     <span class="lineart">╰──</span> SignonIdentityInfo
265 </pre>
266 </div>
267 <div class="refsect1">
268 <a name="SignonIdentityInfo.description"></a><h2>Description</h2>
269 <p><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> represents data contained in a database record for an identity
270 and provides getters and setters for individual items.</p>
271 <p>See <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> for a detailed discussion
272 of what each item means and how and when it's used.</p>
273 </div>
274 <div class="refsect1">
275 <a name="SignonIdentityInfo.functions_details"></a><h2>Functions</h2>
276 <div class="refsect2">
277 <a name="signon-identity-info-access-control-list-append"></a><h3>signon_identity_info_access_control_list_append ()</h3>
278 <pre class="programlisting"><span class="returnvalue">void</span>
279 signon_identity_info_access_control_list_append
280                                (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
281                                 <em class="parameter"><code><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *security_context</code></em>);</pre>
282 <p>Appends a new <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> item to the access control list.</p>
283 <div class="refsect3">
284 <a name="id-1.3.3.4.7.2.5"></a><h4>Parameters</h4>
285 <div class="informaltable"><table width="100%" border="0">
286 <colgroup>
287 <col width="150px" class="parameters_name">
288 <col class="parameters_description">
289 <col width="200px" class="parameters_annotations">
290 </colgroup>
291 <tbody>
292 <tr>
293 <td class="parameter_name"><p>info</p></td>
294 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
295 <td class="parameter_annotations"> </td>
296 </tr>
297 <tr>
298 <td class="parameter_name"><p>security_context</p></td>
299 <td class="parameter_description"><p> a security context to be appended. </p></td>
300 <td class="parameter_annotations"><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
301 </tr>
302 </tbody>
303 </table></div>
304 </div>
305 </div>
306 <hr>
307 <div class="refsect2">
308 <a name="signon-identity-info-copy"></a><h3>signon_identity_info_copy ()</h3>
309 <pre class="programlisting"><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="returnvalue">SignonIdentityInfo</span></a> *
310 signon_identity_info_copy (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *other</code></em>);</pre>
311 <p>Get a newly-allocated copy of <em class="parameter"><code>info</code></em>
312 .</p>
313 <div class="refsect3">
314 <a name="id-1.3.3.4.7.3.5"></a><h4>Parameters</h4>
315 <div class="informaltable"><table width="100%" border="0">
316 <colgroup>
317 <col width="150px" class="parameters_name">
318 <col class="parameters_description">
319 <col width="200px" class="parameters_annotations">
320 </colgroup>
321 <tbody><tr>
322 <td class="parameter_name"><p>other</p></td>
323 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
324 <td class="parameter_annotations"> </td>
325 </tr></tbody>
326 </table></div>
327 </div>
328 <div class="refsect3">
329 <a name="id-1.3.3.4.7.3.6"></a><h4>Returns</h4>
330 <p> a copy of the given <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on failure.</p>
331 <p></p>
332 </div>
333 </div>
334 <hr>
335 <div class="refsect2">
336 <a name="signon-identity-info-free"></a><h3>signon_identity_info_free ()</h3>
337 <pre class="programlisting"><span class="returnvalue">void</span>
338 signon_identity_info_free (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);</pre>
339 <p>Destroys the given <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> item.</p>
340 <div class="refsect3">
341 <a name="id-1.3.3.4.7.4.5"></a><h4>Parameters</h4>
342 <div class="informaltable"><table width="100%" border="0">
343 <colgroup>
344 <col width="150px" class="parameters_name">
345 <col class="parameters_description">
346 <col width="200px" class="parameters_annotations">
347 </colgroup>
348 <tbody><tr>
349 <td class="parameter_name"><p>info</p></td>
350 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
351 <td class="parameter_annotations"> </td>
352 </tr></tbody>
353 </table></div>
354 </div>
355 </div>
356 <hr>
357 <div class="refsect2">
358 <a name="signon-identity-info-get-access-control-list"></a><h3>signon_identity_info_get_access_control_list ()</h3>
359 <pre class="programlisting"><a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="returnvalue">SignonSecurityContextList</span></a> *
360 signon_identity_info_get_access_control_list
361                                (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);</pre>
362 <p>Get an access control list associated with an identity.</p>
363 <div class="refsect3">
364 <a name="id-1.3.3.4.7.5.5"></a><h4>Parameters</h4>
365 <div class="informaltable"><table width="100%" border="0">
366 <colgroup>
367 <col width="150px" class="parameters_name">
368 <col class="parameters_description">
369 <col width="200px" class="parameters_annotations">
370 </colgroup>
371 <tbody><tr>
372 <td class="parameter_name"><p>info</p></td>
373 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
374 <td class="parameter_annotations"> </td>
375 </tr></tbody>
376 </table></div>
377 </div>
378 <div class="refsect3">
379 <a name="id-1.3.3.4.7.5.6"></a><h4>Returns</h4>
380 <p> a list of ACL security contexts. </p>
381 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
382 </div>
383 </div>
384 <hr>
385 <div class="refsect2">
386 <a name="signon-identity-info-get-caption"></a><h3>signon_identity_info_get_caption ()</h3>
387 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
388 signon_identity_info_get_caption (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);</pre>
389 <p>Get the display name of <em class="parameter"><code>info</code></em>
390 .</p>
391 <div class="refsect3">
392 <a name="id-1.3.3.4.7.6.5"></a><h4>Parameters</h4>
393 <div class="informaltable"><table width="100%" border="0">
394 <colgroup>
395 <col width="150px" class="parameters_name">
396 <col class="parameters_description">
397 <col width="200px" class="parameters_annotations">
398 </colgroup>
399 <tbody><tr>
400 <td class="parameter_name"><p>info</p></td>
401 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
402 <td class="parameter_annotations"> </td>
403 </tr></tbody>
404 </table></div>
405 </div>
406 <div class="refsect3">
407 <a name="id-1.3.3.4.7.6.6"></a><h4>Returns</h4>
408 <p> the display name for the identity.</p>
409 <p></p>
410 </div>
411 </div>
412 <hr>
413 <div class="refsect2">
414 <a name="signon-identity-info-get-id"></a><h3>signon_identity_info_get_id ()</h3>
415 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
416 signon_identity_info_get_id (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);</pre>
417 <p>Get the numeric identity ID of <em class="parameter"><code>info</code></em>
418 .</p>
419 <div class="refsect3">
420 <a name="id-1.3.3.4.7.7.5"></a><h4>Parameters</h4>
421 <div class="informaltable"><table width="100%" border="0">
422 <colgroup>
423 <col width="150px" class="parameters_name">
424 <col class="parameters_description">
425 <col width="200px" class="parameters_annotations">
426 </colgroup>
427 <tbody><tr>
428 <td class="parameter_name"><p>info</p></td>
429 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
430 <td class="parameter_annotations"> </td>
431 </tr></tbody>
432 </table></div>
433 </div>
434 <div class="refsect3">
435 <a name="id-1.3.3.4.7.7.6"></a><h4>Returns</h4>
436 <p> the numeric ID of the identity.</p>
437 <p></p>
438 </div>
439 </div>
440 <hr>
441 <div class="refsect2">
442 <a name="signon-identity-info-get-identity-type"></a><h3>signon_identity_info_get_identity_type ()</h3>
443 <pre class="programlisting"><a class="link" href="SignonIdentityInfo.html#SignonIdentityType" title="enum SignonIdentityType"><span class="returnvalue">SignonIdentityType</span></a>
444 signon_identity_info_get_identity_type
445                                (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);</pre>
446 <p>Get the type of the identity.</p>
447 <div class="refsect3">
448 <a name="id-1.3.3.4.7.8.5"></a><h4>Parameters</h4>
449 <div class="informaltable"><table width="100%" border="0">
450 <colgroup>
451 <col width="150px" class="parameters_name">
452 <col class="parameters_description">
453 <col width="200px" class="parameters_annotations">
454 </colgroup>
455 <tbody><tr>
456 <td class="parameter_name"><p>info</p></td>
457 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
458 <td class="parameter_annotations"> </td>
459 </tr></tbody>
460 </table></div>
461 </div>
462 <div class="refsect3">
463 <a name="id-1.3.3.4.7.8.6"></a><h4>Returns</h4>
464 <p> the type of the identity.</p>
465 <p></p>
466 </div>
467 </div>
468 <hr>
469 <div class="refsect2">
470 <a name="signon-identity-info-get-methods"></a><h3>signon_identity_info_get_methods ()</h3>
471 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> *
472 signon_identity_info_get_methods (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);</pre>
473 <p>Get a hash table of the methods and mechanisms of <em class="parameter"><code>info</code></em>
474 . See 
475 <a class="link" href="SignonIdentityInfo.html#signon-identity-info-set-methods" title="signon_identity_info_set_methods ()"><code class="function">signon_identity_info_set_methods()</code></a>.</p>
476 <div class="refsect3">
477 <a name="id-1.3.3.4.7.9.5"></a><h4>Parameters</h4>
478 <div class="informaltable"><table width="100%" border="0">
479 <colgroup>
480 <col width="150px" class="parameters_name">
481 <col class="parameters_description">
482 <col width="200px" class="parameters_annotations">
483 </colgroup>
484 <tbody><tr>
485 <td class="parameter_name"><p>info</p></td>
486 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
487 <td class="parameter_annotations"> </td>
488 </tr></tbody>
489 </table></div>
490 </div>
491 <div class="refsect3">
492 <a name="id-1.3.3.4.7.9.6"></a><h4>Returns</h4>
493 <p> (element-type utf8 GStrv): the table of allowed
494 methods and mechanisms. </p>
495 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
496 </div>
497 </div>
498 <hr>
499 <div class="refsect2">
500 <a name="signon-identity-info-get-owner"></a><h3>signon_identity_info_get_owner ()</h3>
501 <pre class="programlisting">const <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="returnvalue">SignonSecurityContext</span></a> *
502 signon_identity_info_get_owner (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);</pre>
503 <p>Get identity owner's security context.</p>
504 <div class="refsect3">
505 <a name="id-1.3.3.4.7.10.5"></a><h4>Parameters</h4>
506 <div class="informaltable"><table width="100%" border="0">
507 <colgroup>
508 <col width="150px" class="parameters_name">
509 <col class="parameters_description">
510 <col width="200px" class="parameters_annotations">
511 </colgroup>
512 <tbody><tr>
513 <td class="parameter_name"><p>info</p></td>
514 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
515 <td class="parameter_annotations"> </td>
516 </tr></tbody>
517 </table></div>
518 </div>
519 <div class="refsect3">
520 <a name="id-1.3.3.4.7.10.6"></a><h4>Returns</h4>
521 <p> a security context. </p>
522 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
523 </div>
524 </div>
525 <hr>
526 <div class="refsect2">
527 <a name="signon-identity-info-get-realms"></a><h3>signon_identity_info_get_realms ()</h3>
528 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *
529 signon_identity_info_get_realms (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);</pre>
530 <p>Get an array of the allowed realms of <em class="parameter"><code>info</code></em>
531 .</p>
532 <div class="refsect3">
533 <a name="id-1.3.3.4.7.11.5"></a><h4>Parameters</h4>
534 <div class="informaltable"><table width="100%" border="0">
535 <colgroup>
536 <col width="150px" class="parameters_name">
537 <col class="parameters_description">
538 <col width="200px" class="parameters_annotations">
539 </colgroup>
540 <tbody><tr>
541 <td class="parameter_name"><p>info</p></td>
542 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
543 <td class="parameter_annotations"> </td>
544 </tr></tbody>
545 </table></div>
546 </div>
547 <div class="refsect3">
548 <a name="id-1.3.3.4.7.11.6"></a><h4>Returns</h4>
549 <p> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> terminated array of realms. </p>
550 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
551 </div>
552 </div>
553 <hr>
554 <div class="refsect2">
555 <a name="signon-identity-info-get-storing-secret"></a><h3>signon_identity_info_get_storing_secret ()</h3>
556 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
557 signon_identity_info_get_storing_secret
558                                (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);</pre>
559 <p>Get whether the secret of <em class="parameter"><code>info</code></em>
560  should be stored by gSSO in the secret database.</p>
561 <div class="refsect3">
562 <a name="id-1.3.3.4.7.12.5"></a><h4>Parameters</h4>
563 <div class="informaltable"><table width="100%" border="0">
564 <colgroup>
565 <col width="150px" class="parameters_name">
566 <col class="parameters_description">
567 <col width="200px" class="parameters_annotations">
568 </colgroup>
569 <tbody><tr>
570 <td class="parameter_name"><p>info</p></td>
571 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
572 <td class="parameter_annotations"> </td>
573 </tr></tbody>
574 </table></div>
575 </div>
576 <div class="refsect3">
577 <a name="id-1.3.3.4.7.12.6"></a><h4>Returns</h4>
578 <p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if gSSO must store the secret, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
579 <p></p>
580 </div>
581 </div>
582 <hr>
583 <div class="refsect2">
584 <a name="signon-identity-info-get-username"></a><h3>signon_identity_info_get_username ()</h3>
585 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
586 signon_identity_info_get_username (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);</pre>
587 <p>Get the username associated with an identity.</p>
588 <div class="refsect3">
589 <a name="id-1.3.3.4.7.13.5"></a><h4>Parameters</h4>
590 <div class="informaltable"><table width="100%" border="0">
591 <colgroup>
592 <col width="150px" class="parameters_name">
593 <col class="parameters_description">
594 <col width="200px" class="parameters_annotations">
595 </colgroup>
596 <tbody><tr>
597 <td class="parameter_name"><p>info</p></td>
598 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
599 <td class="parameter_annotations"> </td>
600 </tr></tbody>
601 </table></div>
602 </div>
603 <div class="refsect3">
604 <a name="id-1.3.3.4.7.13.6"></a><h4>Returns</h4>
605 <p> the username, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
606 <p></p>
607 </div>
608 </div>
609 <hr>
610 <div class="refsect2">
611 <a name="signon-identity-info-new"></a><h3>signon_identity_info_new ()</h3>
612 <pre class="programlisting"><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="returnvalue">SignonIdentityInfo</span></a> *
613 signon_identity_info_new ();</pre>
614 <p>Creates a new <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> item.</p>
615 <div class="refsect3">
616 <a name="id-1.3.3.4.7.14.5"></a><h4>Returns</h4>
617 <p> a new <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> item.</p>
618 <p></p>
619 </div>
620 </div>
621 <hr>
622 <div class="refsect2">
623 <a name="signon-identity-info-own-methods"></a><h3>signon_identity_info_own_methods ()</h3>
624 <pre class="programlisting"><span class="returnvalue">void</span>
625 signon_identity_info_own_methods (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
626                                   <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *methods</code></em>);</pre>
627 <p>Set authentication methods that are allowed to be used with this identity.</p>
628 <p>This function will just increment reference count of hash table, so
629 it should be constructed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#g-hash-table-new-full"><span class="type">g_hash_table_new_full</span></a>.</p>
630 <div class="refsect3">
631 <a name="id-1.3.3.4.7.15.6"></a><h4>Parameters</h4>
632 <div class="informaltable"><table width="100%" border="0">
633 <colgroup>
634 <col width="150px" class="parameters_name">
635 <col class="parameters_description">
636 <col width="200px" class="parameters_annotations">
637 </colgroup>
638 <tbody>
639 <tr>
640 <td class="parameter_name"><p>info</p></td>
641 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
642 <td class="parameter_annotations"> </td>
643 </tr>
644 <tr>
645 <td class="parameter_name"><p>methods</p></td>
646 <td class="parameter_description"><p> (element-type utf8 GStrv): methods. </p></td>
647 <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>
648 </tr>
649 </tbody>
650 </table></div>
651 </div>
652 </div>
653 <hr>
654 <div class="refsect2">
655 <a name="signon-identity-info-remove-method"></a><h3>signon_identity_info_remove_method ()</h3>
656 <pre class="programlisting"><span class="returnvalue">void</span>
657 signon_identity_info_remove_method (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
658                                     <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> *method</code></em>);</pre>
659 <p>Remove <em class="parameter"><code>method</code></em>
660  from the list of allowed authentication methods.</p>
661 <div class="refsect3">
662 <a name="id-1.3.3.4.7.16.5"></a><h4>Parameters</h4>
663 <div class="informaltable"><table width="100%" border="0">
664 <colgroup>
665 <col width="150px" class="parameters_name">
666 <col class="parameters_description">
667 <col width="200px" class="parameters_annotations">
668 </colgroup>
669 <tbody>
670 <tr>
671 <td class="parameter_name"><p>info</p></td>
672 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
673 <td class="parameter_annotations"> </td>
674 </tr>
675 <tr>
676 <td class="parameter_name"><p>method</p></td>
677 <td class="parameter_description"><p>an authentication method.</p></td>
678 <td class="parameter_annotations"> </td>
679 </tr>
680 </tbody>
681 </table></div>
682 </div>
683 </div>
684 <hr>
685 <div class="refsect2">
686 <a name="signon-identity-info-set-access-control-list"></a><h3>signon_identity_info_set_access_control_list ()</h3>
687 <pre class="programlisting"><span class="returnvalue">void</span>
688 signon_identity_info_set_access_control_list
689                                (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
690                                 <em class="parameter"><code><a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a> *access_control_list</code></em>);</pre>
691 <p>Set an access control list associated with an identity.</p>
692 <div class="refsect3">
693 <a name="id-1.3.3.4.7.17.5"></a><h4>Parameters</h4>
694 <div class="informaltable"><table width="100%" border="0">
695 <colgroup>
696 <col width="150px" class="parameters_name">
697 <col class="parameters_description">
698 <col width="200px" class="parameters_annotations">
699 </colgroup>
700 <tbody>
701 <tr>
702 <td class="parameter_name"><p>info</p></td>
703 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
704 <td class="parameter_annotations"> </td>
705 </tr>
706 <tr>
707 <td class="parameter_name"><p>access_control_list</p></td>
708 <td class="parameter_description"><p> a list of ACL security contexts. </p></td>
709 <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>
710 </tr>
711 </tbody>
712 </table></div>
713 </div>
714 </div>
715 <hr>
716 <div class="refsect2">
717 <a name="signon-identity-info-set-caption"></a><h3>signon_identity_info_set_caption ()</h3>
718 <pre class="programlisting"><span class="returnvalue">void</span>
719 signon_identity_info_set_caption (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
720                                   <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> *caption</code></em>);</pre>
721 <p>Sets the caption (display name) for the identity.</p>
722 <div class="refsect3">
723 <a name="id-1.3.3.4.7.18.5"></a><h4>Parameters</h4>
724 <div class="informaltable"><table width="100%" border="0">
725 <colgroup>
726 <col width="150px" class="parameters_name">
727 <col class="parameters_description">
728 <col width="200px" class="parameters_annotations">
729 </colgroup>
730 <tbody>
731 <tr>
732 <td class="parameter_name"><p>info</p></td>
733 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
734 <td class="parameter_annotations"> </td>
735 </tr>
736 <tr>
737 <td class="parameter_name"><p>caption</p></td>
738 <td class="parameter_description"><p>the caption.</p></td>
739 <td class="parameter_annotations"> </td>
740 </tr>
741 </tbody>
742 </table></div>
743 </div>
744 </div>
745 <hr>
746 <div class="refsect2">
747 <a name="signon-identity-info-set-identity-type"></a><h3>signon_identity_info_set_identity_type ()</h3>
748 <pre class="programlisting"><span class="returnvalue">void</span>
749 signon_identity_info_set_identity_type
750                                (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
751                                 <em class="parameter"><code><a class="link" href="SignonIdentityInfo.html#SignonIdentityType" title="enum SignonIdentityType"><span class="type">SignonIdentityType</span></a> type</code></em>);</pre>
752 <p>Specifies the type of this identity.</p>
753 <div class="refsect3">
754 <a name="id-1.3.3.4.7.19.5"></a><h4>Parameters</h4>
755 <div class="informaltable"><table width="100%" border="0">
756 <colgroup>
757 <col width="150px" class="parameters_name">
758 <col class="parameters_description">
759 <col width="200px" class="parameters_annotations">
760 </colgroup>
761 <tbody>
762 <tr>
763 <td class="parameter_name"><p>info</p></td>
764 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
765 <td class="parameter_annotations"> </td>
766 </tr>
767 <tr>
768 <td class="parameter_name"><p>type</p></td>
769 <td class="parameter_description"><p>the type of the identity.</p></td>
770 <td class="parameter_annotations"> </td>
771 </tr>
772 </tbody>
773 </table></div>
774 </div>
775 </div>
776 <hr>
777 <div class="refsect2">
778 <a name="signon-identity-info-set-method"></a><h3>signon_identity_info_set_method ()</h3>
779 <pre class="programlisting"><span class="returnvalue">void</span>
780 signon_identity_info_set_method (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
781                                  <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> *method</code></em>,
782                                  <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> * const *mechanisms</code></em>);</pre>
783 <p>Adds a method to the list of allowed authentication methods.</p>
784 <div class="refsect3">
785 <a name="id-1.3.3.4.7.20.5"></a><h4>Parameters</h4>
786 <div class="informaltable"><table width="100%" border="0">
787 <colgroup>
788 <col width="150px" class="parameters_name">
789 <col class="parameters_description">
790 <col width="200px" class="parameters_annotations">
791 </colgroup>
792 <tbody>
793 <tr>
794 <td class="parameter_name"><p>info</p></td>
795 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
796 <td class="parameter_annotations"> </td>
797 </tr>
798 <tr>
799 <td class="parameter_name"><p>method</p></td>
800 <td class="parameter_description"><p>an authentication method.</p></td>
801 <td class="parameter_annotations"> </td>
802 </tr>
803 <tr>
804 <td class="parameter_name"><p>mechanisms</p></td>
805 <td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of mechanisms.</p></td>
806 <td class="parameter_annotations"> </td>
807 </tr>
808 </tbody>
809 </table></div>
810 </div>
811 </div>
812 <hr>
813 <div class="refsect2">
814 <a name="signon-identity-info-set-methods"></a><h3>signon_identity_info_set_methods ()</h3>
815 <pre class="programlisting"><span class="returnvalue">void</span>
816 signon_identity_info_set_methods (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
817                                   <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *methods</code></em>);</pre>
818 <p>Set authentication methods that are allowed to be used with this identity.</p>
819 <div class="refsect3">
820 <a name="id-1.3.3.4.7.21.5"></a><h4>Parameters</h4>
821 <div class="informaltable"><table width="100%" border="0">
822 <colgroup>
823 <col width="150px" class="parameters_name">
824 <col class="parameters_description">
825 <col width="200px" class="parameters_annotations">
826 </colgroup>
827 <tbody>
828 <tr>
829 <td class="parameter_name"><p>info</p></td>
830 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
831 <td class="parameter_annotations"> </td>
832 </tr>
833 <tr>
834 <td class="parameter_name"><p>methods</p></td>
835 <td class="parameter_description"><p> (element-type utf8 GStrv): methods. </p></td>
836 <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>
837 </tr>
838 </tbody>
839 </table></div>
840 </div>
841 </div>
842 <hr>
843 <div class="refsect2">
844 <a name="signon-identity-info-set-owner"></a><h3>signon_identity_info_set_owner ()</h3>
845 <pre class="programlisting"><span class="returnvalue">void</span>
846 signon_identity_info_set_owner (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
847                                 <em class="parameter"><code>const <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *owner</code></em>);</pre>
848 <p>Set identity owner's security context.</p>
849 <div class="refsect3">
850 <a name="id-1.3.3.4.7.22.5"></a><h4>Parameters</h4>
851 <div class="informaltable"><table width="100%" border="0">
852 <colgroup>
853 <col width="150px" class="parameters_name">
854 <col class="parameters_description">
855 <col width="200px" class="parameters_annotations">
856 </colgroup>
857 <tbody>
858 <tr>
859 <td class="parameter_name"><p>info</p></td>
860 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
861 <td class="parameter_annotations"> </td>
862 </tr>
863 <tr>
864 <td class="parameter_name"><p>owner</p></td>
865 <td class="parameter_description"><p> a security context of owner. </p></td>
866 <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>
867 </tr>
868 </tbody>
869 </table></div>
870 </div>
871 </div>
872 <hr>
873 <div class="refsect2">
874 <a name="signon-identity-info-set-owner-from-values"></a><h3>signon_identity_info_set_owner_from_values ()</h3>
875 <pre class="programlisting"><span class="returnvalue">void</span>
876 signon_identity_info_set_owner_from_values
877                                (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
878                                 <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> *system_context</code></em>,
879                                 <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> *application_context</code></em>);</pre>
880 <p>Set identity owner's security context.</p>
881 <div class="refsect3">
882 <a name="id-1.3.3.4.7.23.5"></a><h4>Parameters</h4>
883 <div class="informaltable"><table width="100%" border="0">
884 <colgroup>
885 <col width="150px" class="parameters_name">
886 <col class="parameters_description">
887 <col width="200px" class="parameters_annotations">
888 </colgroup>
889 <tbody>
890 <tr>
891 <td class="parameter_name"><p>info</p></td>
892 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
893 <td class="parameter_annotations"> </td>
894 </tr>
895 <tr>
896 <td class="parameter_name"><p>system_context</p></td>
897 <td class="parameter_description"><p>owner's system context.</p></td>
898 <td class="parameter_annotations"> </td>
899 </tr>
900 <tr>
901 <td class="parameter_name"><p>application_context</p></td>
902 <td class="parameter_description"><p>owner's application context.</p></td>
903 <td class="parameter_annotations"> </td>
904 </tr>
905 </tbody>
906 </table></div>
907 </div>
908 </div>
909 <hr>
910 <div class="refsect2">
911 <a name="signon-identity-info-set-realms"></a><h3>signon_identity_info_set_realms ()</h3>
912 <pre class="programlisting"><span class="returnvalue">void</span>
913 signon_identity_info_set_realms (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
914                                  <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> * const *realms</code></em>);</pre>
915 <p>Specify what realms this identity can be used in.</p>
916 <div class="refsect3">
917 <a name="id-1.3.3.4.7.24.5"></a><h4>Parameters</h4>
918 <div class="informaltable"><table width="100%" border="0">
919 <colgroup>
920 <col width="150px" class="parameters_name">
921 <col class="parameters_description">
922 <col width="200px" class="parameters_annotations">
923 </colgroup>
924 <tbody>
925 <tr>
926 <td class="parameter_name"><p>info</p></td>
927 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
928 <td class="parameter_annotations"> </td>
929 </tr>
930 <tr>
931 <td class="parameter_name"><p>realms</p></td>
932 <td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of realms.</p></td>
933 <td class="parameter_annotations"> </td>
934 </tr>
935 </tbody>
936 </table></div>
937 </div>
938 </div>
939 <hr>
940 <div class="refsect2">
941 <a name="signon-identity-info-set-secret"></a><h3>signon_identity_info_set_secret ()</h3>
942 <pre class="programlisting"><span class="returnvalue">void</span>
943 signon_identity_info_set_secret (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
944                                  <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> *secret</code></em>,
945                                  <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> store_secret</code></em>);</pre>
946 <p>Sets the secret (password) for the identity, and whether the gSSO daemon
947 should remember it.</p>
948 <div class="refsect3">
949 <a name="id-1.3.3.4.7.25.5"></a><h4>Parameters</h4>
950 <div class="informaltable"><table width="100%" border="0">
951 <colgroup>
952 <col width="150px" class="parameters_name">
953 <col class="parameters_description">
954 <col width="200px" class="parameters_annotations">
955 </colgroup>
956 <tbody>
957 <tr>
958 <td class="parameter_name"><p>info</p></td>
959 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
960 <td class="parameter_annotations"> </td>
961 </tr>
962 <tr>
963 <td class="parameter_name"><p>secret</p></td>
964 <td class="parameter_description"><p>the secret.</p></td>
965 <td class="parameter_annotations"> </td>
966 </tr>
967 <tr>
968 <td class="parameter_name"><p>store_secret</p></td>
969 <td class="parameter_description"><p>whether signond should store the secret in its DB.</p></td>
970 <td class="parameter_annotations"> </td>
971 </tr>
972 </tbody>
973 </table></div>
974 </div>
975 </div>
976 <hr>
977 <div class="refsect2">
978 <a name="signon-identity-info-set-username"></a><h3>signon_identity_info_set_username ()</h3>
979 <pre class="programlisting"><span class="returnvalue">void</span>
980 signon_identity_info_set_username (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
981                                    <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>
982 <p>Sets the username for the identity.</p>
983 <div class="refsect3">
984 <a name="id-1.3.3.4.7.26.5"></a><h4>Parameters</h4>
985 <div class="informaltable"><table width="100%" border="0">
986 <colgroup>
987 <col width="150px" class="parameters_name">
988 <col class="parameters_description">
989 <col width="200px" class="parameters_annotations">
990 </colgroup>
991 <tbody>
992 <tr>
993 <td class="parameter_name"><p>info</p></td>
994 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
995 <td class="parameter_annotations"> </td>
996 </tr>
997 <tr>
998 <td class="parameter_name"><p>username</p></td>
999 <td class="parameter_description"><p>the username.</p></td>
1000 <td class="parameter_annotations"> </td>
1001 </tr>
1002 </tbody>
1003 </table></div>
1004 </div>
1005 </div>
1006 </div>
1007 <div class="refsect1">
1008 <a name="SignonIdentityInfo.other_details"></a><h2>Types and Values</h2>
1009 <div class="refsect2">
1010 <a name="SignonIdentityInfo-struct"></a><h3>SignonIdentityInfo</h3>
1011 <pre class="programlisting">typedef struct _SignonIdentityInfo SignonIdentityInfo;</pre>
1012 <p>Opaque struct. Use the accessor functions below.</p>
1013 </div>
1014 <hr>
1015 <div class="refsect2">
1016 <a name="SignonIdentityType"></a><h3>enum SignonIdentityType</h3>
1017 <p>Identity types used in <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p>
1018 <div class="refsect3">
1019 <a name="id-1.3.3.4.8.3.4"></a><h4>Members</h4>
1020 <div class="informaltable"><table width="100%" border="0">
1021 <colgroup>
1022 <col width="300px" class="enum_members_name">
1023 <col class="enum_members_description">
1024 <col width="200px" class="enum_members_annotations">
1025 </colgroup>
1026 <tbody>
1027 <tr>
1028 <td class="enum_member_name"><p><a name="SIGNON-IDENTITY-TYPE-OTHER:CAPS"></a>SIGNON_IDENTITY_TYPE_OTHER</p></td>
1029 <td class="enum_member_description">
1030 <p>an identity that is not an app, web or network</p>
1031 </td>
1032 <td class="enum_member_annotations"> </td>
1033 </tr>
1034 <tr>
1035 <td class="enum_member_name"><p><a name="SIGNON-IDENTITY-TYPE-APP:CAPS"></a>SIGNON_IDENTITY_TYPE_APP</p></td>
1036 <td class="enum_member_description">
1037 <p>an application identity</p>
1038 </td>
1039 <td class="enum_member_annotations"> </td>
1040 </tr>
1041 <tr>
1042 <td class="enum_member_name"><p><a name="SIGNON-IDENTITY-TYPE-WEB:CAPS"></a>SIGNON_IDENTITY_TYPE_WEB</p></td>
1043 <td class="enum_member_description">
1044 <p>a web identity</p>
1045 </td>
1046 <td class="enum_member_annotations"> </td>
1047 </tr>
1048 <tr>
1049 <td class="enum_member_name"><p><a name="SIGNON-IDENTITY-TYPE-NETWORK:CAPS"></a>SIGNON_IDENTITY_TYPE_NETWORK</p></td>
1050 <td class="enum_member_description">
1051 <p>a network server identity</p>
1052 </td>
1053 <td class="enum_member_annotations"> </td>
1054 </tr>
1055 </tbody>
1056 </table></div>
1057 </div>
1058 </div>
1059 </div>
1060 </div>
1061 <div class="footer">
1062 <hr>
1063           Generated by GTK-Doc V1.20</div>
1064 </body>
1065 </html>