1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
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">
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>
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>
26 <div class="refentry">
27 <a name="SignonIdentityInfo"></a><div class="titlepage"></div>
28 <div class="refnamediv"><table width="100%"><tr>
30 <h2><span class="refentrytitle"><a name="SignonIdentityInfo.top_of_page"></a>SignonIdentityInfo</span></h2>
31 <p>SignonIdentityInfo — data contained in a SignonIdentity.</p>
33 <td class="gallery_image" valign="top" align="right"></td>
35 <div class="refsect1">
36 <a name="SignonIdentityInfo.functions"></a><h2>Functions</h2>
37 <div class="informaltable"><table width="100%" border="0">
39 <col width="150px" class="functions_return">
40 <col class="functions_name">
44 <td class="function_type">
45 <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="returnvalue">SignonIdentityInfo</span></a> *
47 <td class="function_name">
48 <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>
52 <td class="function_type">
53 <span class="returnvalue">void</span>
55 <td class="function_name">
56 <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>
60 <td class="function_type">
61 <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="returnvalue">SignonIdentityInfo</span></a> *
63 <td class="function_name">
64 <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>
68 <td class="function_type">
69 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
71 <td class="function_name">
72 <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>
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> *
78 <td class="function_name">
79 <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>
83 <td class="function_type">
84 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
86 <td class="function_name">
87 <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>
91 <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> *
93 <td class="function_name">
94 <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>
98 <td class="function_type">
99 <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> *
101 <td class="function_name">
102 <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>
106 <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 *
108 <td class="function_name">
109 <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>
113 <td class="function_type">const <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="returnvalue">SignonSecurityContext</span></a> *
115 <td class="function_name">
116 <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>
120 <td class="function_type">
121 <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="returnvalue">SignonSecurityContextList</span></a> *
123 <td class="function_name">
124 <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>
128 <td class="function_type">
129 <a class="link" href="SignonIdentityInfo.html#SignonIdentityType" title="enum SignonIdentityType"><span class="returnvalue">SignonIdentityType</span></a>
131 <td class="function_name">
132 <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>
136 <td class="function_type">
137 <span class="returnvalue">void</span>
139 <td class="function_name">
140 <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>
144 <td class="function_type">
145 <span class="returnvalue">void</span>
147 <td class="function_name">
148 <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>
152 <td class="function_type">
153 <span class="returnvalue">void</span>
155 <td class="function_name">
156 <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>
160 <td class="function_type">
161 <span class="returnvalue">void</span>
163 <td class="function_name">
164 <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>
168 <td class="function_type">
169 <span class="returnvalue">void</span>
171 <td class="function_name">
172 <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>
176 <td class="function_type">
177 <span class="returnvalue">void</span>
179 <td class="function_name">
180 <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>
184 <td class="function_type">
185 <span class="returnvalue">void</span>
187 <td class="function_name">
188 <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>
192 <td class="function_type">
193 <span class="returnvalue">void</span>
195 <td class="function_name">
196 <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>
200 <td class="function_type">
201 <span class="returnvalue">void</span>
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>
208 <td class="function_type">
209 <span class="returnvalue">void</span>
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>
216 <td class="function_type">
217 <span class="returnvalue">void</span>
219 <td class="function_name">
220 <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>
224 <td class="function_type">
225 <span class="returnvalue">void</span>
227 <td class="function_name">
228 <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>
232 <td class="function_type">
233 <span class="returnvalue">void</span>
235 <td class="function_name">
236 <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>
242 <div class="refsect1">
243 <a name="SignonIdentityInfo.other"></a><h2>Types and Values</h2>
244 <div class="informaltable"><table width="100%" border="0">
246 <col width="150px" class="name">
247 <col class="description">
251 <td class="datatype_keyword">enum</td>
252 <td class="function_name"><a class="link" href="SignonIdentityInfo.html#SignonIdentityType" title="enum SignonIdentityType">SignonIdentityType</a></td>
255 <td class="datatype_keyword"> </td>
256 <td class="function_name"><a class="link" href="SignonIdentityInfo.html#SignonIdentityInfo-struct" title="SignonIdentityInfo">SignonIdentityInfo</a></td>
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
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>
274 <div class="refsect1">
275 <a name="SignonIdentityInfo.functions_details"></a><h2>Functions</h2>
276 <div class="refsect2">
277 <a name="signon-identity-info-new"></a><h3>signon_identity_info_new ()</h3>
278 <pre class="programlisting"><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="returnvalue">SignonIdentityInfo</span></a> *
279 signon_identity_info_new ();</pre>
280 <p>Creates a new <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> item.</p>
281 <div class="refsect3">
282 <a name="id-1.3.3.4.7.2.5"></a><h4>Returns</h4>
283 <p> a new <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> item.</p>
288 <div class="refsect2">
289 <a name="signon-identity-info-free"></a><h3>signon_identity_info_free ()</h3>
290 <pre class="programlisting"><span class="returnvalue">void</span>
291 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>
292 <p>Destroys the given <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> item.</p>
293 <div class="refsect3">
294 <a name="id-1.3.3.4.7.3.5"></a><h4>Parameters</h4>
295 <div class="informaltable"><table width="100%" border="0">
297 <col width="150px" class="parameters_name">
298 <col class="parameters_description">
299 <col width="200px" class="parameters_annotations">
302 <td class="parameter_name"><p>info</p></td>
303 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
304 <td class="parameter_annotations"> </td>
310 <div class="refsect2">
311 <a name="signon-identity-info-copy"></a><h3>signon_identity_info_copy ()</h3>
312 <pre class="programlisting"><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="returnvalue">SignonIdentityInfo</span></a> *
313 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>
314 <p>Get a newly-allocated copy of <em class="parameter"><code>info</code></em>
316 <div class="refsect3">
317 <a name="id-1.3.3.4.7.4.5"></a><h4>Parameters</h4>
318 <div class="informaltable"><table width="100%" border="0">
320 <col width="150px" class="parameters_name">
321 <col class="parameters_description">
322 <col width="200px" class="parameters_annotations">
325 <td class="parameter_name"><p>other</p></td>
326 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
327 <td class="parameter_annotations"> </td>
331 <div class="refsect3">
332 <a name="id-1.3.3.4.7.4.6"></a><h4>Returns</h4>
333 <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>
338 <div class="refsect2">
339 <a name="signon-identity-info-get-id"></a><h3>signon_identity_info_get_id ()</h3>
340 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
341 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>
342 <p>Get the numeric identity ID of <em class="parameter"><code>info</code></em>
344 <div class="refsect3">
345 <a name="id-1.3.3.4.7.5.5"></a><h4>Parameters</h4>
346 <div class="informaltable"><table width="100%" border="0">
348 <col width="150px" class="parameters_name">
349 <col class="parameters_description">
350 <col width="200px" class="parameters_annotations">
353 <td class="parameter_name"><p>info</p></td>
354 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
355 <td class="parameter_annotations"> </td>
359 <div class="refsect3">
360 <a name="id-1.3.3.4.7.5.6"></a><h4>Returns</h4>
361 <p> the numeric ID of the identity.</p>
366 <div class="refsect2">
367 <a name="signon-identity-info-get-username"></a><h3>signon_identity_info_get_username ()</h3>
368 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
369 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>
370 <p>Get the username associated with an identity.</p>
371 <div class="refsect3">
372 <a name="id-1.3.3.4.7.6.5"></a><h4>Parameters</h4>
373 <div class="informaltable"><table width="100%" border="0">
375 <col width="150px" class="parameters_name">
376 <col class="parameters_description">
377 <col width="200px" class="parameters_annotations">
380 <td class="parameter_name"><p>info</p></td>
381 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
382 <td class="parameter_annotations"> </td>
386 <div class="refsect3">
387 <a name="id-1.3.3.4.7.6.6"></a><h4>Returns</h4>
388 <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>
393 <div class="refsect2">
394 <a name="signon-identity-info-get-storing-secret"></a><h3>signon_identity_info_get_storing_secret ()</h3>
395 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
396 signon_identity_info_get_storing_secret
397 (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);</pre>
398 <p>Get whether the secret of <em class="parameter"><code>info</code></em>
399 should be stored by gSSO in the secret database.</p>
400 <div class="refsect3">
401 <a name="id-1.3.3.4.7.7.5"></a><h4>Parameters</h4>
402 <div class="informaltable"><table width="100%" border="0">
404 <col width="150px" class="parameters_name">
405 <col class="parameters_description">
406 <col width="200px" class="parameters_annotations">
409 <td class="parameter_name"><p>info</p></td>
410 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
411 <td class="parameter_annotations"> </td>
415 <div class="refsect3">
416 <a name="id-1.3.3.4.7.7.6"></a><h4>Returns</h4>
417 <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>
422 <div class="refsect2">
423 <a name="signon-identity-info-get-caption"></a><h3>signon_identity_info_get_caption ()</h3>
424 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
425 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>
426 <p>Get the display name of <em class="parameter"><code>info</code></em>
428 <div class="refsect3">
429 <a name="id-1.3.3.4.7.8.5"></a><h4>Parameters</h4>
430 <div class="informaltable"><table width="100%" border="0">
432 <col width="150px" class="parameters_name">
433 <col class="parameters_description">
434 <col width="200px" class="parameters_annotations">
437 <td class="parameter_name"><p>info</p></td>
438 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
439 <td class="parameter_annotations"> </td>
443 <div class="refsect3">
444 <a name="id-1.3.3.4.7.8.6"></a><h4>Returns</h4>
445 <p> the display name for the identity.</p>
450 <div class="refsect2">
451 <a name="signon-identity-info-get-methods"></a><h3>signon_identity_info_get_methods ()</h3>
452 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> *
453 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>
454 <p>Get a hash table of the methods and mechanisms of <em class="parameter"><code>info</code></em>
456 <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>
457 <div class="refsect3">
458 <a name="id-1.3.3.4.7.9.5"></a><h4>Parameters</h4>
459 <div class="informaltable"><table width="100%" border="0">
461 <col width="150px" class="parameters_name">
462 <col class="parameters_description">
463 <col width="200px" class="parameters_annotations">
466 <td class="parameter_name"><p>info</p></td>
467 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
468 <td class="parameter_annotations"> </td>
472 <div class="refsect3">
473 <a name="id-1.3.3.4.7.9.6"></a><h4>Returns</h4>
474 <p> (element-type utf8 GStrv): the table of allowed
475 methods and mechanisms. </p>
476 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
480 <div class="refsect2">
481 <a name="signon-identity-info-get-realms"></a><h3>signon_identity_info_get_realms ()</h3>
482 <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 *
483 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>
484 <p>Get an array of the allowed realms of <em class="parameter"><code>info</code></em>
486 <div class="refsect3">
487 <a name="id-1.3.3.4.7.10.5"></a><h4>Parameters</h4>
488 <div class="informaltable"><table width="100%" border="0">
490 <col width="150px" class="parameters_name">
491 <col class="parameters_description">
492 <col width="200px" class="parameters_annotations">
495 <td class="parameter_name"><p>info</p></td>
496 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
497 <td class="parameter_annotations"> </td>
501 <div class="refsect3">
502 <a name="id-1.3.3.4.7.10.6"></a><h4>Returns</h4>
503 <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>
504 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
508 <div class="refsect2">
509 <a name="signon-identity-info-get-owner"></a><h3>signon_identity_info_get_owner ()</h3>
510 <pre class="programlisting">const <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="returnvalue">SignonSecurityContext</span></a> *
511 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>
512 <p>Get identity owner's security context.</p>
513 <div class="refsect3">
514 <a name="id-1.3.3.4.7.11.5"></a><h4>Parameters</h4>
515 <div class="informaltable"><table width="100%" border="0">
517 <col width="150px" class="parameters_name">
518 <col class="parameters_description">
519 <col width="200px" class="parameters_annotations">
522 <td class="parameter_name"><p>info</p></td>
523 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
524 <td class="parameter_annotations"> </td>
528 <div class="refsect3">
529 <a name="id-1.3.3.4.7.11.6"></a><h4>Returns</h4>
530 <p> a security context. </p>
531 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
535 <div class="refsect2">
536 <a name="signon-identity-info-get-access-control-list"></a><h3>signon_identity_info_get_access_control_list ()</h3>
537 <pre class="programlisting"><a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="returnvalue">SignonSecurityContextList</span></a> *
538 signon_identity_info_get_access_control_list
539 (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);</pre>
540 <p>Get an access control list associated with an identity.</p>
541 <div class="refsect3">
542 <a name="id-1.3.3.4.7.12.5"></a><h4>Parameters</h4>
543 <div class="informaltable"><table width="100%" border="0">
545 <col width="150px" class="parameters_name">
546 <col class="parameters_description">
547 <col width="200px" class="parameters_annotations">
550 <td class="parameter_name"><p>info</p></td>
551 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
552 <td class="parameter_annotations"> </td>
556 <div class="refsect3">
557 <a name="id-1.3.3.4.7.12.6"></a><h4>Returns</h4>
558 <p> a list of ACL security contexts. </p>
559 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
563 <div class="refsect2">
564 <a name="signon-identity-info-get-identity-type"></a><h3>signon_identity_info_get_identity_type ()</h3>
565 <pre class="programlisting"><a class="link" href="SignonIdentityInfo.html#SignonIdentityType" title="enum SignonIdentityType"><span class="returnvalue">SignonIdentityType</span></a>
566 signon_identity_info_get_identity_type
567 (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);</pre>
568 <p>Get the type of the identity.</p>
569 <div class="refsect3">
570 <a name="id-1.3.3.4.7.13.5"></a><h4>Parameters</h4>
571 <div class="informaltable"><table width="100%" border="0">
573 <col width="150px" class="parameters_name">
574 <col class="parameters_description">
575 <col width="200px" class="parameters_annotations">
578 <td class="parameter_name"><p>info</p></td>
579 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
580 <td class="parameter_annotations"> </td>
584 <div class="refsect3">
585 <a name="id-1.3.3.4.7.13.6"></a><h4>Returns</h4>
586 <p> the type of the identity.</p>
591 <div class="refsect2">
592 <a name="signon-identity-info-set-username"></a><h3>signon_identity_info_set_username ()</h3>
593 <pre class="programlisting"><span class="returnvalue">void</span>
594 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>,
595 <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>
596 <p>Sets the username for the identity.</p>
597 <div class="refsect3">
598 <a name="id-1.3.3.4.7.14.5"></a><h4>Parameters</h4>
599 <div class="informaltable"><table width="100%" border="0">
601 <col width="150px" class="parameters_name">
602 <col class="parameters_description">
603 <col width="200px" class="parameters_annotations">
607 <td class="parameter_name"><p>info</p></td>
608 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
609 <td class="parameter_annotations"> </td>
612 <td class="parameter_name"><p>username</p></td>
613 <td class="parameter_description"><p>the username.</p></td>
614 <td class="parameter_annotations"> </td>
621 <div class="refsect2">
622 <a name="signon-identity-info-set-secret"></a><h3>signon_identity_info_set_secret ()</h3>
623 <pre class="programlisting"><span class="returnvalue">void</span>
624 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>,
625 <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>,
626 <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>
627 <p>Sets the secret (password) for the identity, and whether the gSSO daemon
628 should remember it.</p>
629 <div class="refsect3">
630 <a name="id-1.3.3.4.7.15.5"></a><h4>Parameters</h4>
631 <div class="informaltable"><table width="100%" border="0">
633 <col width="150px" class="parameters_name">
634 <col class="parameters_description">
635 <col width="200px" class="parameters_annotations">
639 <td class="parameter_name"><p>info</p></td>
640 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
641 <td class="parameter_annotations"> </td>
644 <td class="parameter_name"><p>secret</p></td>
645 <td class="parameter_description"><p>the secret.</p></td>
646 <td class="parameter_annotations"> </td>
649 <td class="parameter_name"><p>store_secret</p></td>
650 <td class="parameter_description"><p>whether signond should store the secret in its DB.</p></td>
651 <td class="parameter_annotations"> </td>
658 <div class="refsect2">
659 <a name="signon-identity-info-set-caption"></a><h3>signon_identity_info_set_caption ()</h3>
660 <pre class="programlisting"><span class="returnvalue">void</span>
661 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>,
662 <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>
663 <p>Sets the caption (display name) for the identity.</p>
664 <div class="refsect3">
665 <a name="id-1.3.3.4.7.16.5"></a><h4>Parameters</h4>
666 <div class="informaltable"><table width="100%" border="0">
668 <col width="150px" class="parameters_name">
669 <col class="parameters_description">
670 <col width="200px" class="parameters_annotations">
674 <td class="parameter_name"><p>info</p></td>
675 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
676 <td class="parameter_annotations"> </td>
679 <td class="parameter_name"><p>caption</p></td>
680 <td class="parameter_description"><p>the caption.</p></td>
681 <td class="parameter_annotations"> </td>
688 <div class="refsect2">
689 <a name="signon-identity-info-set-methods"></a><h3>signon_identity_info_set_methods ()</h3>
690 <pre class="programlisting"><span class="returnvalue">void</span>
691 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>,
692 <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>
693 <p>Set authentication methods that are allowed to be used with this identity.</p>
694 <div class="refsect3">
695 <a name="id-1.3.3.4.7.17.5"></a><h4>Parameters</h4>
696 <div class="informaltable"><table width="100%" border="0">
698 <col width="150px" class="parameters_name">
699 <col class="parameters_description">
700 <col width="200px" class="parameters_annotations">
704 <td class="parameter_name"><p>info</p></td>
705 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
706 <td class="parameter_annotations"> </td>
709 <td class="parameter_name"><p>methods</p></td>
710 <td class="parameter_description"><p> (element-type utf8 GStrv): methods. </p></td>
711 <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>
718 <div class="refsect2">
719 <a name="signon-identity-info-own-methods"></a><h3>signon_identity_info_own_methods ()</h3>
720 <pre class="programlisting"><span class="returnvalue">void</span>
721 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>,
722 <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>
723 <p>Set authentication methods that are allowed to be used with this identity.</p>
724 <p>This function will just increment reference count of hash table, so
725 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>
726 <div class="refsect3">
727 <a name="id-1.3.3.4.7.18.6"></a><h4>Parameters</h4>
728 <div class="informaltable"><table width="100%" border="0">
730 <col width="150px" class="parameters_name">
731 <col class="parameters_description">
732 <col width="200px" class="parameters_annotations">
736 <td class="parameter_name"><p>info</p></td>
737 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
738 <td class="parameter_annotations"> </td>
741 <td class="parameter_name"><p>methods</p></td>
742 <td class="parameter_description"><p> (element-type utf8 GStrv): methods. </p></td>
743 <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>
750 <div class="refsect2">
751 <a name="signon-identity-info-set-method"></a><h3>signon_identity_info_set_method ()</h3>
752 <pre class="programlisting"><span class="returnvalue">void</span>
753 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>,
754 <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>,
755 <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>
756 <p>Adds a method to the list of allowed authentication methods.</p>
757 <div class="refsect3">
758 <a name="id-1.3.3.4.7.19.5"></a><h4>Parameters</h4>
759 <div class="informaltable"><table width="100%" border="0">
761 <col width="150px" class="parameters_name">
762 <col class="parameters_description">
763 <col width="200px" class="parameters_annotations">
767 <td class="parameter_name"><p>info</p></td>
768 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
769 <td class="parameter_annotations"> </td>
772 <td class="parameter_name"><p>method</p></td>
773 <td class="parameter_description"><p>an authentication method.</p></td>
774 <td class="parameter_annotations"> </td>
777 <td class="parameter_name"><p>mechanisms</p></td>
778 <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>
779 <td class="parameter_annotations"> </td>
786 <div class="refsect2">
787 <a name="signon-identity-info-remove-method"></a><h3>signon_identity_info_remove_method ()</h3>
788 <pre class="programlisting"><span class="returnvalue">void</span>
789 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>,
790 <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>
791 <p>Remove <em class="parameter"><code>method</code></em>
792 from the list of allowed authentication methods.</p>
793 <div class="refsect3">
794 <a name="id-1.3.3.4.7.20.5"></a><h4>Parameters</h4>
795 <div class="informaltable"><table width="100%" border="0">
797 <col width="150px" class="parameters_name">
798 <col class="parameters_description">
799 <col width="200px" class="parameters_annotations">
803 <td class="parameter_name"><p>info</p></td>
804 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
805 <td class="parameter_annotations"> </td>
808 <td class="parameter_name"><p>method</p></td>
809 <td class="parameter_description"><p>an authentication method.</p></td>
810 <td class="parameter_annotations"> </td>
817 <div class="refsect2">
818 <a name="signon-identity-info-set-realms"></a><h3>signon_identity_info_set_realms ()</h3>
819 <pre class="programlisting"><span class="returnvalue">void</span>
820 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>,
821 <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>
822 <p>Specify what realms this identity can be used in.</p>
823 <div class="refsect3">
824 <a name="id-1.3.3.4.7.21.5"></a><h4>Parameters</h4>
825 <div class="informaltable"><table width="100%" border="0">
827 <col width="150px" class="parameters_name">
828 <col class="parameters_description">
829 <col width="200px" class="parameters_annotations">
833 <td class="parameter_name"><p>info</p></td>
834 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
835 <td class="parameter_annotations"> </td>
838 <td class="parameter_name"><p>realms</p></td>
839 <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>
840 <td class="parameter_annotations"> </td>
847 <div class="refsect2">
848 <a name="signon-identity-info-set-owner"></a><h3>signon_identity_info_set_owner ()</h3>
849 <pre class="programlisting"><span class="returnvalue">void</span>
850 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>,
851 <em class="parameter"><code>const <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *owner</code></em>);</pre>
852 <p>Set identity owner's security context.</p>
853 <div class="refsect3">
854 <a name="id-1.3.3.4.7.22.5"></a><h4>Parameters</h4>
855 <div class="informaltable"><table width="100%" border="0">
857 <col width="150px" class="parameters_name">
858 <col class="parameters_description">
859 <col width="200px" class="parameters_annotations">
863 <td class="parameter_name"><p>info</p></td>
864 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
865 <td class="parameter_annotations"> </td>
868 <td class="parameter_name"><p>owner</p></td>
869 <td class="parameter_description"><p> a security context of owner. </p></td>
870 <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>
877 <div class="refsect2">
878 <a name="signon-identity-info-set-owner-from-values"></a><h3>signon_identity_info_set_owner_from_values ()</h3>
879 <pre class="programlisting"><span class="returnvalue">void</span>
880 signon_identity_info_set_owner_from_values
881 (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
882 <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>,
883 <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>
884 <p>Set identity owner's security context.</p>
885 <div class="refsect3">
886 <a name="id-1.3.3.4.7.23.5"></a><h4>Parameters</h4>
887 <div class="informaltable"><table width="100%" border="0">
889 <col width="150px" class="parameters_name">
890 <col class="parameters_description">
891 <col width="200px" class="parameters_annotations">
895 <td class="parameter_name"><p>info</p></td>
896 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
897 <td class="parameter_annotations"> </td>
900 <td class="parameter_name"><p>system_context</p></td>
901 <td class="parameter_description"><p>owner's system context.</p></td>
902 <td class="parameter_annotations"> </td>
905 <td class="parameter_name"><p>application_context</p></td>
906 <td class="parameter_description"><p>owner's application context.</p></td>
907 <td class="parameter_annotations"> </td>
914 <div class="refsect2">
915 <a name="signon-identity-info-set-access-control-list"></a><h3>signon_identity_info_set_access_control_list ()</h3>
916 <pre class="programlisting"><span class="returnvalue">void</span>
917 signon_identity_info_set_access_control_list
918 (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
919 <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>
920 <p>Set an access control list associated with an identity.</p>
921 <div class="refsect3">
922 <a name="id-1.3.3.4.7.24.5"></a><h4>Parameters</h4>
923 <div class="informaltable"><table width="100%" border="0">
925 <col width="150px" class="parameters_name">
926 <col class="parameters_description">
927 <col width="200px" class="parameters_annotations">
931 <td class="parameter_name"><p>info</p></td>
932 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
933 <td class="parameter_annotations"> </td>
936 <td class="parameter_name"><p>access_control_list</p></td>
937 <td class="parameter_description"><p> a list of ACL security contexts. </p></td>
938 <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>
945 <div class="refsect2">
946 <a name="signon-identity-info-access-control-list-append"></a><h3>signon_identity_info_access_control_list_append ()</h3>
947 <pre class="programlisting"><span class="returnvalue">void</span>
948 signon_identity_info_access_control_list_append
949 (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
950 <em class="parameter"><code><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *security_context</code></em>);</pre>
951 <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>
952 <div class="refsect3">
953 <a name="id-1.3.3.4.7.25.5"></a><h4>Parameters</h4>
954 <div class="informaltable"><table width="100%" border="0">
956 <col width="150px" class="parameters_name">
957 <col class="parameters_description">
958 <col width="200px" class="parameters_annotations">
962 <td class="parameter_name"><p>info</p></td>
963 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p></td>
964 <td class="parameter_annotations"> </td>
967 <td class="parameter_name"><p>security_context</p></td>
968 <td class="parameter_description"><p> a security context to be appended. </p></td>
969 <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>
976 <div class="refsect2">
977 <a name="signon-identity-info-set-identity-type"></a><h3>signon_identity_info_set_identity_type ()</h3>
978 <pre class="programlisting"><span class="returnvalue">void</span>
979 signon_identity_info_set_identity_type
980 (<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><a class="link" href="SignonIdentityInfo.html#SignonIdentityType" title="enum SignonIdentityType"><span class="type">SignonIdentityType</span></a> type</code></em>);</pre>
982 <p>Specifies the type of this 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">
987 <col width="150px" class="parameters_name">
988 <col class="parameters_description">
989 <col width="200px" class="parameters_annotations">
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>
998 <td class="parameter_name"><p>type</p></td>
999 <td class="parameter_description"><p>the type of the identity.</p></td>
1000 <td class="parameter_annotations"> </td>
1007 <div class="refsect1">
1008 <a name="SignonIdentityInfo.other_details"></a><h2>Types and Values</h2>
1009 <div class="refsect2">
1010 <a name="SignonIdentityType"></a><h3>enum SignonIdentityType</h3>
1011 <p>Identity types used in <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</p>
1012 <div class="refsect3">
1013 <a name="id-1.3.3.4.8.2.4"></a><h4>Members</h4>
1014 <div class="informaltable"><table width="100%" border="0">
1016 <col width="300px" class="enum_members_name">
1017 <col class="enum_members_description">
1018 <col width="200px" class="enum_members_annotations">
1022 <td class="enum_member_name"><p><a name="SIGNON-IDENTITY-TYPE-OTHER:CAPS"></a>SIGNON_IDENTITY_TYPE_OTHER</p></td>
1023 <td class="enum_member_description">
1024 <p>an identity that is not an app, web or network</p>
1026 <td class="enum_member_annotations"> </td>
1029 <td class="enum_member_name"><p><a name="SIGNON-IDENTITY-TYPE-APP:CAPS"></a>SIGNON_IDENTITY_TYPE_APP</p></td>
1030 <td class="enum_member_description">
1031 <p>an application identity</p>
1033 <td class="enum_member_annotations"> </td>
1036 <td class="enum_member_name"><p><a name="SIGNON-IDENTITY-TYPE-WEB:CAPS"></a>SIGNON_IDENTITY_TYPE_WEB</p></td>
1037 <td class="enum_member_description">
1038 <p>a web identity</p>
1040 <td class="enum_member_annotations"> </td>
1043 <td class="enum_member_name"><p><a name="SIGNON-IDENTITY-TYPE-NETWORK:CAPS"></a>SIGNON_IDENTITY_TYPE_NETWORK</p></td>
1044 <td class="enum_member_description">
1045 <p>a network server identity</p>
1047 <td class="enum_member_annotations"> </td>
1054 <div class="refsect2">
1055 <a name="SignonIdentityInfo-struct"></a><h3>SignonIdentityInfo</h3>
1056 <pre class="programlisting">typedef struct _SignonIdentityInfo SignonIdentityInfo;</pre>
1057 <p>Opaque struct. Use the accessor functions below.</p>
1061 <div class="footer">
1063 Generated by GTK-Doc V1.20</div>