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 <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="returnvalue">SignonIdentityInfo</span></a> *
  46 </td>
  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>
  49 </td>
  50 </tr>
  51 <tr>
  52 <td class="function_type">
  53 <span class="returnvalue">void</span>
  54 </td>
  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>
  57 </td>
  58 </tr>
  59 <tr>
  60 <td class="function_type">
  61 <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="returnvalue">SignonIdentityInfo</span></a> *
  62 </td>
  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>
  65 </td>
  66 </tr>
  67 <tr>
  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>
  70 </td>
  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>
  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-username" title="signon_identity_info_get_username ()">signon_identity_info_get_username</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#gboolean"><span class="returnvalue">gboolean</span></a>
  85 </td>
  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>
  88 </td>
  89 </tr>
  90 <tr>
  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> *
  92 </td>
  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>
  95 </td>
  96 </tr>
  97 <tr>
  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> *
 100 </td>
 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>
 103 </td>
 104 </tr>
 105 <tr>
 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 *
 107 </td>
 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>
 110 </td>
 111 </tr>
 112 <tr>
 113 <td class="function_type">const <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="returnvalue">SignonSecurityContext</span></a> *
 114 </td>
 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>
 117 </td>
 118 </tr>
 119 <tr>
 120 <td class="function_type">
 121 <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="returnvalue">SignonSecurityContextList</span></a> *
 122 </td>
 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>
 125 </td>
 126 </tr>
 127 <tr>
 128 <td class="function_type">
 129 <a class="link" href="SignonIdentityInfo.html#SignonIdentityType" title="enum SignonIdentityType"><span class="returnvalue">SignonIdentityType</span></a>
 130 </td>
 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>
 133 </td>
 134 </tr>
 135 <tr>
 136 <td class="function_type">
 137 <span class="returnvalue">void</span>
 138 </td>
 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>
 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-set-secret" title="signon_identity_info_set_secret ()">signon_identity_info_set_secret</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-set-caption" title="signon_identity_info_set_caption ()">signon_identity_info_set_caption</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-methods" title="signon_identity_info_set_methods ()">signon_identity_info_set_methods</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-own-methods" title="signon_identity_info_own_methods ()">signon_identity_info_own_methods</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-method" title="signon_identity_info_set_method ()">signon_identity_info_set_method</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-remove-method" title="signon_identity_info_remove_method ()">signon_identity_info_remove_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-realms" title="signon_identity_info_set_realms ()">signon_identity_info_set_realms</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-access-control-list" title="signon_identity_info_set_access_control_list ()">signon_identity_info_set_access_control_list</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-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>
 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-identity-type" title="signon_identity_info_set_identity_type ()">signon_identity_info_set_identity_type</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">enum</td>
 252 <td class="function_name"><a class="link" href="SignonIdentityInfo.html#SignonIdentityType" title="enum SignonIdentityType">SignonIdentityType</a></td>
 253 </tr>
 254 <tr>
 255 <td class="datatype_keyword"> </td>
 256 <td class="function_name"><a class="link" href="SignonIdentityInfo.html#SignonIdentityInfo-struct" title="SignonIdentityInfo">SignonIdentityInfo</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-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>
 284 <p></p>
 285 </div>
 286 </div>
 287 <hr>
 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">
 296 <colgroup>
 297 <col width="150px" class="parameters_name">
 298 <col class="parameters_description">
 299 <col width="200px" class="parameters_annotations">
 300 </colgroup>
 301 <tbody><tr>
 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>
 305 </tr></tbody>
 306 </table></div>
 307 </div>
 308 </div>
 309 <hr>
 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>
 315 .</p>
 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">
 319 <colgroup>
 320 <col width="150px" class="parameters_name">
 321 <col class="parameters_description">
 322 <col width="200px" class="parameters_annotations">
 323 </colgroup>
 324 <tbody><tr>
 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>
 328 </tr></tbody>
 329 </table></div>
 330 </div>
 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>
 334 <p></p>
 335 </div>
 336 </div>
 337 <hr>
 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>
 343 .</p>
 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">
 347 <colgroup>
 348 <col width="150px" class="parameters_name">
 349 <col class="parameters_description">
 350 <col width="200px" class="parameters_annotations">
 351 </colgroup>
 352 <tbody><tr>
 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>
 356 </tr></tbody>
 357 </table></div>
 358 </div>
 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>
 362 <p></p>
 363 </div>
 364 </div>
 365 <hr>
 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">
 374 <colgroup>
 375 <col width="150px" class="parameters_name">
 376 <col class="parameters_description">
 377 <col width="200px" class="parameters_annotations">
 378 </colgroup>
 379 <tbody><tr>
 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>
 383 </tr></tbody>
 384 </table></div>
 385 </div>
 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>
 389 <p></p>
 390 </div>
 391 </div>
 392 <hr>
 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">
 403 <colgroup>
 404 <col width="150px" class="parameters_name">
 405 <col class="parameters_description">
 406 <col width="200px" class="parameters_annotations">
 407 </colgroup>
 408 <tbody><tr>
 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>
 412 </tr></tbody>
 413 </table></div>
 414 </div>
 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>
 418 <p></p>
 419 </div>
 420 </div>
 421 <hr>
 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>
 427 .</p>
 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">
 431 <colgroup>
 432 <col width="150px" class="parameters_name">
 433 <col class="parameters_description">
 434 <col width="200px" class="parameters_annotations">
 435 </colgroup>
 436 <tbody><tr>
 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>
 440 </tr></tbody>
 441 </table></div>
 442 </div>
 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>
 446 <p></p>
 447 </div>
 448 </div>
 449 <hr>
 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>
 455 . See
 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">
 460 <colgroup>
 461 <col width="150px" class="parameters_name">
 462 <col class="parameters_description">
 463 <col width="200px" class="parameters_annotations">
 464 </colgroup>
 465 <tbody><tr>
 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>
 469 </tr></tbody>
 470 </table></div>
 471 </div>
 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>
 477 </div>
 478 </div>
 479 <hr>
 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>
 485 .</p>
 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">
 489 <colgroup>
 490 <col width="150px" class="parameters_name">
 491 <col class="parameters_description">
 492 <col width="200px" class="parameters_annotations">
 493 </colgroup>
 494 <tbody><tr>
 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>
 498 </tr></tbody>
 499 </table></div>
 500 </div>
 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>
 505 </div>
 506 </div>
 507 <hr>
 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">
 516 <colgroup>
 517 <col width="150px" class="parameters_name">
 518 <col class="parameters_description">
 519 <col width="200px" class="parameters_annotations">
 520 </colgroup>
 521 <tbody><tr>
 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>
 525 </tr></tbody>
 526 </table></div>
 527 </div>
 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>
 532 </div>
 533 </div>
 534 <hr>
 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">
 544 <colgroup>
 545 <col width="150px" class="parameters_name">
 546 <col class="parameters_description">
 547 <col width="200px" class="parameters_annotations">
 548 </colgroup>
 549 <tbody><tr>
 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>
 553 </tr></tbody>
 554 </table></div>
 555 </div>
 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>
 560 </div>
 561 </div>
 562 <hr>
 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">
 572 <colgroup>
 573 <col width="150px" class="parameters_name">
 574 <col class="parameters_description">
 575 <col width="200px" class="parameters_annotations">
 576 </colgroup>
 577 <tbody><tr>
 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>
 581 </tr></tbody>
 582 </table></div>
 583 </div>
 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>
 587 <p></p>
 588 </div>
 589 </div>
 590 <hr>
 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">
 600 <colgroup>
 601 <col width="150px" class="parameters_name">
 602 <col class="parameters_description">
 603 <col width="200px" class="parameters_annotations">
 604 </colgroup>
 605 <tbody>
 606 <tr>
 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>
 610 </tr>
 611 <tr>
 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>
 615 </tr>
 616 </tbody>
 617 </table></div>
 618 </div>
 619 </div>
 620 <hr>
 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">
 632 <colgroup>
 633 <col width="150px" class="parameters_name">
 634 <col class="parameters_description">
 635 <col width="200px" class="parameters_annotations">
 636 </colgroup>
 637 <tbody>
 638 <tr>
 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>
 642 </tr>
 643 <tr>
 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>
 647 </tr>
 648 <tr>
 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>
 652 </tr>
 653 </tbody>
 654 </table></div>
 655 </div>
 656 </div>
 657 <hr>
 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">
 667 <colgroup>
 668 <col width="150px" class="parameters_name">
 669 <col class="parameters_description">
 670 <col width="200px" class="parameters_annotations">
 671 </colgroup>
 672 <tbody>
 673 <tr>
 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>
 677 </tr>
 678 <tr>
 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>
 682 </tr>
 683 </tbody>
 684 </table></div>
 685 </div>
 686 </div>
 687 <hr>
 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">
 697 <colgroup>
 698 <col width="150px" class="parameters_name">
 699 <col class="parameters_description">
 700 <col width="200px" class="parameters_annotations">
 701 </colgroup>
 702 <tbody>
 703 <tr>
 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>
 707 </tr>
 708 <tr>
 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>
 712 </tr>
 713 </tbody>
 714 </table></div>
 715 </div>
 716 </div>
 717 <hr>
 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">
 729 <colgroup>
 730 <col width="150px" class="parameters_name">
 731 <col class="parameters_description">
 732 <col width="200px" class="parameters_annotations">
 733 </colgroup>
 734 <tbody>
 735 <tr>
 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>
 739 </tr>
 740 <tr>
 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>
 744 </tr>
 745 </tbody>
 746 </table></div>
 747 </div>
 748 </div>
 749 <hr>
 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">
 760 <colgroup>
 761 <col width="150px" class="parameters_name">
 762 <col class="parameters_description">
 763 <col width="200px" class="parameters_annotations">
 764 </colgroup>
 765 <tbody>
 766 <tr>
 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>
 770 </tr>
 771 <tr>
 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>
 775 </tr>
 776 <tr>
 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>
 780 </tr>
 781 </tbody>
 782 </table></div>
 783 </div>
 784 </div>
 785 <hr>
 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">
 796 <colgroup>
 797 <col width="150px" class="parameters_name">
 798 <col class="parameters_description">
 799 <col width="200px" class="parameters_annotations">
 800 </colgroup>
 801 <tbody>
 802 <tr>
 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>
 806 </tr>
 807 <tr>
 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>
 811 </tr>
 812 </tbody>
 813 </table></div>
 814 </div>
 815 </div>
 816 <hr>
 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">
 826 <colgroup>
 827 <col width="150px" class="parameters_name">
 828 <col class="parameters_description">
 829 <col width="200px" class="parameters_annotations">
 830 </colgroup>
 831 <tbody>
 832 <tr>
 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>
 836 </tr>
 837 <tr>
 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>
 841 </tr>
 842 </tbody>
 843 </table></div>
 844 </div>
 845 </div>
 846 <hr>
 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">
 856 <colgroup>
 857 <col width="150px" class="parameters_name">
 858 <col class="parameters_description">
 859 <col width="200px" class="parameters_annotations">
 860 </colgroup>
 861 <tbody>
 862 <tr>
 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>
 866 </tr>
 867 <tr>
 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>
 871 </tr>
 872 </tbody>
 873 </table></div>
 874 </div>
 875 </div>
 876 <hr>
 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">
 888 <colgroup>
 889 <col width="150px" class="parameters_name">
 890 <col class="parameters_description">
 891 <col width="200px" class="parameters_annotations">
 892 </colgroup>
 893 <tbody>
 894 <tr>
 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>
 898 </tr>
 899 <tr>
 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>
 903 </tr>
 904 <tr>
 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>
 908 </tr>
 909 </tbody>
 910 </table></div>
 911 </div>
 912 </div>
 913 <hr>
 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">
 924 <colgroup>
 925 <col width="150px" class="parameters_name">
 926 <col class="parameters_description">
 927 <col width="200px" class="parameters_annotations">
 928 </colgroup>
 929 <tbody>
 930 <tr>
 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>
 934 </tr>
 935 <tr>
 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>
 939 </tr>
 940 </tbody>
 941 </table></div>
 942 </div>
 943 </div>
 944 <hr>
 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">
 955 <colgroup>
 956 <col width="150px" class="parameters_name">
 957 <col class="parameters_description">
 958 <col width="200px" class="parameters_annotations">
 959 </colgroup>
 960 <tbody>
 961 <tr>
 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>
 965 </tr>
 966 <tr>
 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>
 970 </tr>
 971 </tbody>
 972 </table></div>
 973 </div>
 974 </div>
 975 <hr>
 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">
 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>type</p></td>
 999 <td class="parameter_description"><p>the type of the identity.</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="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">
1015 <colgroup>
1016 <col width="300px" class="enum_members_name">
1017 <col class="enum_members_description">
1018 <col width="200px" class="enum_members_annotations">
1019 </colgroup>
1020 <tbody>
1021 <tr>
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>
1025 </td>
1026 <td class="enum_member_annotations"> </td>
1027 </tr>
1028 <tr>
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>
1032 </td>
1033 <td class="enum_member_annotations"> </td>
1034 </tr>
1035 <tr>
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>
1039 </td>
1040 <td class="enum_member_annotations"> </td>
1041 </tr>
1042 <tr>
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>
1046 </td>
1047 <td class="enum_member_annotations"> </td>
1048 </tr>
1049 </tbody>
1050 </table></div>
1051 </div>
1052 </div>
1053 <hr>
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>
1058 </div>
1059 </div>
1060 </div>
1061 <div class="footer">
1062 <hr>
1063           Generated by GTK-Doc V1.20</div>
1064 </body>
1065 </html>