docs/reference/html/SignonAuthSession.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: SignonAuthSession</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="SignonSecurityContext.html" title="SignonSecurityContext">
  10 <link rel="next" href="libgsignon-glib-SignonError.html" title="SignonError">
  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="#SignonAuthSession.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
  19                   <a href="#SignonAuthSession.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_properties"> <span class="dim">|</span>
  20                   <a href="#SignonAuthSession.properties" class="shortcut">Properties</a></span><span id="nav_signals"> <span class="dim">|</span>
  21                   <a href="#SignonAuthSession.signals" class="shortcut">Signals</a></span>
  22 </td>
  23 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
  24 <td><a accesskey="u" href="credential-management.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
  25 <td><a accesskey="p" href="SignonSecurityContext.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
  26 <td><a accesskey="n" href="libgsignon-glib-SignonError.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
  27 </tr></table>
  28 <div class="refentry">
  29 <a name="SignonAuthSession"></a><div class="titlepage"></div>
  30 <div class="refnamediv"><table width="100%"><tr>
  31 <td valign="top">
  32 <h2><span class="refentrytitle"><a name="SignonAuthSession.top_of_page"></a>SignonAuthSession</span></h2>
  33 <p>SignonAuthSession — the authentication session object</p>
  34 </td>
  35 <td class="gallery_image" valign="top" align="right"></td>
  36 </tr></table></div>
  37 <div class="refsect1">
  38 <a name="SignonAuthSession.functions"></a><h2>Functions</h2>
  39 <div class="informaltable"><table width="100%" border="0">
  40 <colgroup>
  41 <col width="150px" class="functions_return">
  42 <col class="functions_name">
  43 </colgroup>
  44 <tbody>
  45 <tr>
  46 <td class="function_type">
  47 <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="returnvalue">SignonAuthSession</span></a> *
  48 </td>
  49 <td class="function_name">
  50 <a class="link" href="SignonAuthSession.html#signon-auth-session-new" title="signon_auth_session_new ()">signon_auth_session_new</a> <span class="c_punctuation">()</span>
  51 </td>
  52 </tr>
  53 <tr>
  54 <td class="function_type">
  55 <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="returnvalue">SignonAuthSession</span></a> *
  56 </td>
  57 <td class="function_name">
  58 <a class="link" href="SignonAuthSession.html#signon-auth-session-new-for-identity" title="signon_auth_session_new_for_identity ()">signon_auth_session_new_for_identity</a> <span class="c_punctuation">()</span>
  59 </td>
  60 </tr>
  61 <tr>
  62 <td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
  63 </td>
  64 <td class="function_name">
  65 <a class="link" href="SignonAuthSession.html#signon-auth-session-get-method" title="signon_auth_session_get_method ()">signon_auth_session_get_method</a> <span class="c_punctuation">()</span>
  66 </td>
  67 </tr>
  68 <tr>
  69 <td class="function_type">
  70 <span class="returnvalue">void</span>
  71 </td>
  72 <td class="function_name">
  73 <span class="c_punctuation">(</span><a class="link" href="SignonAuthSession.html#SignonAuthSessionQueryAvailableMechanismsCb" title="SignonAuthSessionQueryAvailableMechanismsCb ()">*SignonAuthSessionQueryAvailableMechanismsCb</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
  74 </td>
  75 </tr>
  76 <tr>
  77 <td class="function_type">
  78 <span class="returnvalue">void</span>
  79 </td>
  80 <td class="function_name">
  81 <a class="link" href="SignonAuthSession.html#signon-auth-session-query-available-mechanisms" title="signon_auth_session_query_available_mechanisms ()">signon_auth_session_query_available_mechanisms</a> <span class="c_punctuation">()</span>
  82 </td>
  83 </tr>
  84 <tr>
  85 <td class="function_type">
  86 <span class="returnvalue">void</span>
  87 </td>
  88 <td class="function_name">
  89 <span class="c_punctuation">(</span><a class="link" href="SignonAuthSession.html#SignonAuthSessionProcessCb" title="SignonAuthSessionProcessCb ()">*SignonAuthSessionProcessCb</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
  90 </td>
  91 </tr>
  92 <tr>
  93 <td class="function_type">
  94 <span class="returnvalue">void</span>
  95 </td>
  96 <td class="function_name">
  97 <a class="link" href="SignonAuthSession.html#signon-auth-session-process" title="signon_auth_session_process ()">signon_auth_session_process</a> <span class="c_punctuation">()</span>
  98 </td>
  99 </tr>
 100 <tr>
 101 <td class="function_type">
 102 <span class="returnvalue">void</span>
 103 </td>
 104 <td class="function_name">
 105 <a class="link" href="SignonAuthSession.html#signon-auth-session-process-async" title="signon_auth_session_process_async ()">signon_auth_session_process_async</a> <span class="c_punctuation">()</span>
 106 </td>
 107 </tr>
 108 <tr>
 109 <td class="function_type">
 110 <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
 111 </td>
 112 <td class="function_name">
 113 <a class="link" href="SignonAuthSession.html#signon-auth-session-process-finish" title="signon_auth_session_process_finish ()">signon_auth_session_process_finish</a> <span class="c_punctuation">()</span>
 114 </td>
 115 </tr>
 116 <tr>
 117 <td class="function_type">
 118 <span class="returnvalue">void</span>
 119 </td>
 120 <td class="function_name">
 121 <a class="link" href="SignonAuthSession.html#signon-auth-session-cancel" title="signon_auth_session_cancel ()">signon_auth_session_cancel</a> <span class="c_punctuation">()</span>
 122 </td>
 123 </tr>
 124 </tbody>
 125 </table></div>
 126 </div>
 127 <div class="refsect1">
 128 <a name="SignonAuthSession.properties"></a><h2>Properties</h2>
 129 <div class="informaltable"><table border="0">
 130 <colgroup>
 131 <col width="150px" class="properties_type">
 132 <col width="300px" class="properties_name">
 133 <col width="200px" class="properties_flags">
 134 </colgroup>
 135 <tbody><tr>
 136 <td class="property_type">
 137 <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> *</td>
 138 <td class="property_name"><a class="link" href="SignonAuthSession.html#SignonAuthSession--identity" title="The “identity” property">identity</a></td>
 139 <td class="property_flags">Read / Write / Construct Only</td>
 140 </tr></tbody>
 141 </table></div>
 142 </div>
 143 <div class="refsect1">
 144 <a name="SignonAuthSession.signals"></a><h2>Signals</h2>
 145 <div class="informaltable"><table border="0">
 146 <colgroup>
 147 <col width="150px" class="signals_return">
 148 <col width="300px" class="signals_name">
 149 <col width="200px" class="signals_flags">
 150 </colgroup>
 151 <tbody><tr>
 152 <td class="signal_type"><span class="returnvalue">void</span></td>
 153 <td class="signal_name"><a class="link" href="SignonAuthSession.html#SignonAuthSession-state-changed" title="The “state-changed” signal">state-changed</a></td>
 154 <td class="signal_flags"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></td>
 155 </tr></tbody>
 156 </table></div>
 157 </div>
 158 <div class="refsect1">
 159 <a name="SignonAuthSession.other"></a><h2>Types and Values</h2>
 160 <div class="informaltable"><table width="100%" border="0">
 161 <colgroup>
 162 <col width="150px" class="name">
 163 <col class="description">
 164 </colgroup>
 165 <tbody>
 166 <tr>
 167 <td class="define_keyword">#define</td>
 168 <td class="function_name"><a class="link" href="SignonAuthSession.html#SIGNON-SESSION-DATA-USERNAME:CAPS" title="SIGNON_SESSION_DATA_USERNAME">SIGNON_SESSION_DATA_USERNAME</a></td>
 169 </tr>
 170 <tr>
 171 <td class="define_keyword">#define</td>
 172 <td class="function_name"><a class="link" href="SignonAuthSession.html#SIGNON-SESSION-DATA-SECRET:CAPS" title="SIGNON_SESSION_DATA_SECRET">SIGNON_SESSION_DATA_SECRET</a></td>
 173 </tr>
 174 <tr>
 175 <td class="define_keyword">#define</td>
 176 <td class="function_name"><a class="link" href="SignonAuthSession.html#SIGNON-SESSION-DATA-REALM:CAPS" title="SIGNON_SESSION_DATA_REALM">SIGNON_SESSION_DATA_REALM</a></td>
 177 </tr>
 178 <tr>
 179 <td class="define_keyword">#define</td>
 180 <td class="function_name"><a class="link" href="SignonAuthSession.html#SIGNON-SESSION-DATA-PROXY:CAPS" title="SIGNON_SESSION_DATA_PROXY">SIGNON_SESSION_DATA_PROXY</a></td>
 181 </tr>
 182 <tr>
 183 <td class="datatype_keyword">enum</td>
 184 <td class="function_name"><a class="link" href="SignonAuthSession.html#SignonSessionDataUiPolicy" title="enum SignonSessionDataUiPolicy">SignonSessionDataUiPolicy</a></td>
 185 </tr>
 186 <tr>
 187 <td class="define_keyword">#define</td>
 188 <td class="function_name"><a class="link" href="SignonAuthSession.html#SIGNON-SESSION-DATA-UI-POLICY:CAPS" title="SIGNON_SESSION_DATA_UI_POLICY">SIGNON_SESSION_DATA_UI_POLICY</a></td>
 189 </tr>
 190 <tr>
 191 <td class="define_keyword">#define</td>
 192 <td class="function_name"><a class="link" href="SignonAuthSession.html#SIGNON-SESSION-DATA-CAPTION:CAPS" title="SIGNON_SESSION_DATA_CAPTION">SIGNON_SESSION_DATA_CAPTION</a></td>
 193 </tr>
 194 <tr>
 195 <td class="define_keyword">#define</td>
 196 <td class="function_name"><a class="link" href="SignonAuthSession.html#SIGNON-SESSION-DATA-TIMEOUT:CAPS" title="SIGNON_SESSION_DATA_TIMEOUT">SIGNON_SESSION_DATA_TIMEOUT</a></td>
 197 </tr>
 198 <tr>
 199 <td class="define_keyword">#define</td>
 200 <td class="function_name"><a class="link" href="SignonAuthSession.html#SIGNON-SESSION-DATA-WINDOW-ID:CAPS" title="SIGNON_SESSION_DATA_WINDOW_ID">SIGNON_SESSION_DATA_WINDOW_ID</a></td>
 201 </tr>
 202 <tr>
 203 <td class="define_keyword">#define</td>
 204 <td class="function_name"><a class="link" href="SignonAuthSession.html#SIGNON-SESSION-DATA-RENEW-TOKEN:CAPS" title="SIGNON_SESSION_DATA_RENEW_TOKEN">SIGNON_SESSION_DATA_RENEW_TOKEN</a></td>
 205 </tr>
 206 <tr>
 207 <td class="datatype_keyword">struct</td>
 208 <td class="function_name"><a class="link" href="SignonAuthSession.html#SignonAuthSession-struct" title="struct SignonAuthSession">SignonAuthSession</a></td>
 209 </tr>
 210 <tr>
 211 <td class="datatype_keyword">struct</td>
 212 <td class="function_name"><a class="link" href="SignonAuthSession.html#SignonAuthSessionClass" title="struct SignonAuthSessionClass">SignonAuthSessionClass</a></td>
 213 </tr>
 214 </tbody>
 215 </table></div>
 216 </div>
 217 <div class="refsect1">
 218 <a name="SignonAuthSession.object-hierarchy"></a><h2>Object Hierarchy</h2>
 219 <pre class="screen">    <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 220     <span class="lineart">╰──</span> SignonAuthSession
 221 </pre>
 222 </div>
 223 <div class="refsect1">
 224 <a name="SignonAuthSession.description"></a><h2>Description</h2>
 225 <p>The <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a> object is responsible for handling the client
 226 authentication. <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a> objects should be created from existing
 227 identities (via <a class="link" href="SignonIdentity.html#signon-identity-create-session" title="signon_identity_create_session ()"><code class="function">signon_identity_create_session()</code></a> or by passing a non-NULL identity
 228 to <a class="link" href="SignonAuthSession.html#signon-auth-session-new" title="signon_auth_session_new ()"><code class="function">signon_auth_session_new()</code></a>).</p>
 229 </div>
 230 <div class="refsect1">
 231 <a name="SignonAuthSession.functions_details"></a><h2>Functions</h2>
 232 <div class="refsect2">
 233 <a name="signon-auth-session-new"></a><h3>signon_auth_session_new ()</h3>
 234 <pre class="programlisting"><a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="returnvalue">SignonAuthSession</span></a> *
 235 signon_auth_session_new (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> id</code></em>,
 236                          <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_name</code></em>,
 237                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
 238 <p>Creates a new <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a>, which can be used to authenticate using
 239 the specified method.</p>
 240 <div class="refsect3">
 241 <a name="id-1.3.3.6.9.2.5"></a><h4>Parameters</h4>
 242 <div class="informaltable"><table width="100%" border="0">
 243 <colgroup>
 244 <col width="150px" class="parameters_name">
 245 <col class="parameters_description">
 246 <col width="200px" class="parameters_annotations">
 247 </colgroup>
 248 <tbody>
 249 <tr>
 250 <td class="parameter_name"><p>id</p></td>
 251 <td class="parameter_description"><p>the id of the <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> to be used. Can be 0, if this session is
 252 not bound to any stored identity.</p></td>
 253 <td class="parameter_annotations"> </td>
 254 </tr>
 255 <tr>
 256 <td class="parameter_name"><p>method_name</p></td>
 257 <td class="parameter_description"><p>the name of the authentication method to be used.</p></td>
 258 <td class="parameter_annotations"> </td>
 259 </tr>
 260 <tr>
 261 <td class="parameter_name"><p>err</p></td>
 262 <td class="parameter_description"><p>a pointer to a location which will contain the error, in case this
 263 function fails.</p></td>
 264 <td class="parameter_annotations"> </td>
 265 </tr>
 266 </tbody>
 267 </table></div>
 268 </div>
 269 <div class="refsect3">
 270 <a name="id-1.3.3.6.9.2.6"></a><h4>Returns</h4>
 271 <p> a new <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a>.</p>
 272 <p></p>
 273 </div>
 274 </div>
 275 <hr>
 276 <div class="refsect2">
 277 <a name="signon-auth-session-new-for-identity"></a><h3>signon_auth_session_new_for_identity ()</h3>
 278 <pre class="programlisting"><a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="returnvalue">SignonAuthSession</span></a> *
 279 signon_auth_session_new_for_identity (<em class="parameter"><code><a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> *identity</code></em>,
 280                                       <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_name</code></em>,
 281                                       <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
 282 <p>Creates a new <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a>, which can be used to authenticate using
 283 the specified method.</p>
 284 <div class="refsect3">
 285 <a name="id-1.3.3.6.9.3.5"></a><h4>Parameters</h4>
 286 <div class="informaltable"><table width="100%" border="0">
 287 <colgroup>
 288 <col width="150px" class="parameters_name">
 289 <col class="parameters_description">
 290 <col width="200px" class="parameters_annotations">
 291 </colgroup>
 292 <tbody>
 293 <tr>
 294 <td class="parameter_name"><p>identity</p></td>
 295 <td class="parameter_description"><p><a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> parent object.</p></td>
 296 <td class="parameter_annotations"> </td>
 297 </tr>
 298 <tr>
 299 <td class="parameter_name"><p>method_name</p></td>
 300 <td class="parameter_description"><p>the name of the authentication method to be used.</p></td>
 301 <td class="parameter_annotations"> </td>
 302 </tr>
 303 <tr>
 304 <td class="parameter_name"><p>err</p></td>
 305 <td class="parameter_description"><p>a pointer to a location which will contain the error, in case this
 306 function fails.</p></td>
 307 <td class="parameter_annotations"> </td>
 308 </tr>
 309 </tbody>
 310 </table></div>
 311 </div>
 312 <div class="refsect3">
 313 <a name="id-1.3.3.6.9.3.6"></a><h4>Returns</h4>
 314 <p> a new <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a>.</p>
 315 <p></p>
 316 </div>
 317 </div>
 318 <hr>
 319 <div class="refsect2">
 320 <a name="signon-auth-session-get-method"></a><h3>signon_auth_session_get_method ()</h3>
 321 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 322 signon_auth_session_get_method (<em class="parameter"><code><a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a> *self</code></em>);</pre>
 323 <p>Get the current authentication method.</p>
 324 <div class="refsect3">
 325 <a name="id-1.3.3.6.9.4.5"></a><h4>Parameters</h4>
 326 <div class="informaltable"><table width="100%" border="0">
 327 <colgroup>
 328 <col width="150px" class="parameters_name">
 329 <col class="parameters_description">
 330 <col width="200px" class="parameters_annotations">
 331 </colgroup>
 332 <tbody><tr>
 333 <td class="parameter_name"><p>self</p></td>
 334 <td class="parameter_description"><p>the <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a>.</p></td>
 335 <td class="parameter_annotations"> </td>
 336 </tr></tbody>
 337 </table></div>
 338 </div>
 339 <div class="refsect3">
 340 <a name="id-1.3.3.6.9.4.6"></a><h4>Returns</h4>
 341 <p> the authentication method being used, 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>
 342 <p></p>
 343 </div>
 344 </div>
 345 <hr>
 346 <div class="refsect2">
 347 <a name="SignonAuthSessionQueryAvailableMechanismsCb"></a><h3>SignonAuthSessionQueryAvailableMechanismsCb ()</h3>
 348 <pre class="programlisting"><span class="returnvalue">void</span>
 349 <span class="c_punctuation">(</span>*SignonAuthSessionQueryAvailableMechanismsCb<span class="c_punctuation">)</span>
 350                                (<em class="parameter"><code><a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a> *self</code></em>,
 351                                 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **mechanisms</code></em>,
 352                                 <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 353                                 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 354 <p>Callback to be passed to <a class="link" href="SignonAuthSession.html#signon-auth-session-query-available-mechanisms" title="signon_auth_session_query_available_mechanisms ()"><code class="function">signon_auth_session_query_available_mechanisms()</code></a>.</p>
 355 <div class="refsect3">
 356 <a name="id-1.3.3.6.9.5.5"></a><h4>Parameters</h4>
 357 <div class="informaltable"><table width="100%" border="0">
 358 <colgroup>
 359 <col width="150px" class="parameters_name">
 360 <col class="parameters_description">
 361 <col width="200px" class="parameters_annotations">
 362 </colgroup>
 363 <tbody>
 364 <tr>
 365 <td class="parameter_name"><p>self</p></td>
 366 <td class="parameter_description"><p>the <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a>.</p></td>
 367 <td class="parameter_annotations"> </td>
 368 </tr>
 369 <tr>
 370 <td class="parameter_name"><p>mechanisms</p></td>
 371 <td class="parameter_description"><p> list of available mechanisms. </p></td>
 372 <td class="parameter_annotations"><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GStrv]</span></td>
 373 </tr>
 374 <tr>
 375 <td class="parameter_name"><p>error</p></td>
 376 <td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> if an error occurred, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> otherwise.</p></td>
 377 <td class="parameter_annotations"> </td>
 378 </tr>
 379 <tr>
 380 <td class="parameter_name"><p>user_data</p></td>
 381 <td class="parameter_description"><p>the user data that was passed when installing this callback.</p></td>
 382 <td class="parameter_annotations"> </td>
 383 </tr>
 384 </tbody>
 385 </table></div>
 386 </div>
 387 </div>
 388 <hr>
 389 <div class="refsect2">
 390 <a name="signon-auth-session-query-available-mechanisms"></a><h3>signon_auth_session_query_available_mechanisms ()</h3>
 391 <pre class="programlisting"><span class="returnvalue">void</span>
 392 signon_auth_session_query_available_mechanisms
 393                                (<em class="parameter"><code><a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a> *self</code></em>,
 394                                 <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> **wanted_mechanisms</code></em>,
 395                                 <em class="parameter"><code><a class="link" href="SignonAuthSession.html#SignonAuthSessionQueryAvailableMechanismsCb" title="SignonAuthSessionQueryAvailableMechanismsCb ()"><span class="type">SignonAuthSessionQueryAvailableMechanismsCb</span></a> cb</code></em>,
 396                                 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 397 <div class="warning"><p><code class="literal">signon_auth_session_query_available_mechanisms</code> is deprecated and should not be used in newly-written code.</p></div>
 398 <p>Queries the mechanisms available for this authentication session. The result
 399 will be the intersection between <em class="parameter"><code>wanted_mechanisms</code></em>
 400  and the mechanisms
 401 supported by the authentication plugin (and allowed by the <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> that this
 402 session belongs to).</p>
 403 <div class="refsect3">
 404 <a name="id-1.3.3.6.9.6.6"></a><h4>Parameters</h4>
 405 <div class="informaltable"><table width="100%" border="0">
 406 <colgroup>
 407 <col width="150px" class="parameters_name">
 408 <col class="parameters_description">
 409 <col width="200px" class="parameters_annotations">
 410 </colgroup>
 411 <tbody>
 412 <tr>
 413 <td class="parameter_name"><p>self</p></td>
 414 <td class="parameter_description"><p>the <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a>.</p></td>
 415 <td class="parameter_annotations"> </td>
 416 </tr>
 417 <tr>
 418 <td class="parameter_name"><p>wanted_mechanisms</p></td>
 419 <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 supported by the client.</p></td>
 420 <td class="parameter_annotations"> </td>
 421 </tr>
 422 <tr>
 423 <td class="parameter_name"><p>cb</p></td>
 424 <td class="parameter_description"><p> a callback which will be called with the result. </p></td>
 425 <td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td>
 426 </tr>
 427 <tr>
 428 <td class="parameter_name"><p>user_data</p></td>
 429 <td class="parameter_description"><p>user data to be passed to the callback.</p></td>
 430 <td class="parameter_annotations"> </td>
 431 </tr>
 432 </tbody>
 433 </table></div>
 434 </div>
 435 </div>
 436 <hr>
 437 <div class="refsect2">
 438 <a name="SignonAuthSessionProcessCb"></a><h3>SignonAuthSessionProcessCb ()</h3>
 439 <pre class="programlisting"><span class="returnvalue">void</span>
 440 <span class="c_punctuation">(</span>*SignonAuthSessionProcessCb<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a> *self</code></em>,
 441                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *session_data</code></em>,
 442                                <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 443                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 444 <div class="warning"><p><code class="literal">SignonAuthSessionProcessCb</code> is deprecated and should not be used in newly-written code.</p></div>
 445 <p>This callback is invoked when the authentication plugin delivers the result
 446 of the <a class="link" href="SignonAuthSession.html#signon-auth-session-process" title="signon_auth_session_process ()"><code class="function">signon_auth_session_process()</code></a> operation.</p>
 447 <div class="refsect3">
 448 <a name="id-1.3.3.6.9.7.6"></a><h4>Parameters</h4>
 449 <div class="informaltable"><table width="100%" border="0">
 450 <colgroup>
 451 <col width="150px" class="parameters_name">
 452 <col class="parameters_description">
 453 <col width="200px" class="parameters_annotations">
 454 </colgroup>
 455 <tbody>
 456 <tr>
 457 <td class="parameter_name"><p>self</p></td>
 458 <td class="parameter_description"><p>the <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a>.</p></td>
 459 <td class="parameter_annotations"> </td>
 460 </tr>
 461 <tr>
 462 <td class="parameter_name"><p>session_data</p></td>
 463 <td class="parameter_description"><p> a dictionary with
 464 the response. </p></td>
 465 <td class="parameter_annotations"><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GValue]</span></td>
 466 </tr>
 467 <tr>
 468 <td class="parameter_name"><p>error</p></td>
 469 <td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> if an error occurred, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> otherwise.</p></td>
 470 <td class="parameter_annotations"> </td>
 471 </tr>
 472 <tr>
 473 <td class="parameter_name"><p>user_data</p></td>
 474 <td class="parameter_description"><p>the user data that was passed when installing this callback.</p></td>
 475 <td class="parameter_annotations"> </td>
 476 </tr>
 477 </tbody>
 478 </table></div>
 479 </div>
 480 </div>
 481 <hr>
 482 <div class="refsect2">
 483 <a name="signon-auth-session-process"></a><h3>signon_auth_session_process ()</h3>
 484 <pre class="programlisting"><span class="returnvalue">void</span>
 485 signon_auth_session_process (<em class="parameter"><code><a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a> *self</code></em>,
 486                              <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *session_data</code></em>,
 487                              <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> *mechanism</code></em>,
 488                              <em class="parameter"><code><a class="link" href="SignonAuthSession.html#SignonAuthSessionProcessCb" title="SignonAuthSessionProcessCb ()"><span class="type">SignonAuthSessionProcessCb</span></a> cb</code></em>,
 489                              <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 490 <div class="warning">
 491 <p><code class="literal">signon_auth_session_process</code> has been deprecated since version 1.8 and should not be used in newly-written code.</p>
 492 <p>Use <a class="link" href="SignonAuthSession.html#signon-auth-session-process-async" title="signon_auth_session_process_async ()"><code class="function">signon_auth_session_process_async()</code></a> instead.</p>
 493 </div>
 494 <p>Performs one step of the authentication process. If the <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> that
 495 this session belongs to contains a username and a password, they will be also
 496 passed to the authentication plugin, otherwise they should be set directly in
 497 <em class="parameter"><code>session_data</code></em>
 498 .
 499 <em class="parameter"><code>session_data</code></em>
 500  should be used to add additional authentication parameters to the
 501 session, or to override the parameters otherwise taken from the identity.</p>
 502 <div class="refsect3">
 503 <a name="id-1.3.3.6.9.8.6"></a><h4>Parameters</h4>
 504 <div class="informaltable"><table width="100%" border="0">
 505 <colgroup>
 506 <col width="150px" class="parameters_name">
 507 <col class="parameters_description">
 508 <col width="200px" class="parameters_annotations">
 509 </colgroup>
 510 <tbody>
 511 <tr>
 512 <td class="parameter_name"><p>self</p></td>
 513 <td class="parameter_description"><p>the <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a>.</p></td>
 514 <td class="parameter_annotations"> </td>
 515 </tr>
 516 <tr>
 517 <td class="parameter_name"><p>session_data</p></td>
 518 <td class="parameter_description"><p> a dictionary of parameters. </p></td>
 519 <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>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GValue]</span></td>
 520 </tr>
 521 <tr>
 522 <td class="parameter_name"><p>mechanism</p></td>
 523 <td class="parameter_description"><p>the authentication mechanism to be used.</p></td>
 524 <td class="parameter_annotations"> </td>
 525 </tr>
 526 <tr>
 527 <td class="parameter_name"><p>cb</p></td>
 528 <td class="parameter_description"><p> a callback which will be called with the result. </p></td>
 529 <td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td>
 530 </tr>
 531 <tr>
 532 <td class="parameter_name"><p>user_data</p></td>
 533 <td class="parameter_description"><p>user data to be passed to the callback.</p></td>
 534 <td class="parameter_annotations"> </td>
 535 </tr>
 536 </tbody>
 537 </table></div>
 538 </div>
 539 </div>
 540 <hr>
 541 <div class="refsect2">
 542 <a name="signon-auth-session-process-async"></a><h3>signon_auth_session_process_async ()</h3>
 543 <pre class="programlisting"><span class="returnvalue">void</span>
 544 signon_auth_session_process_async (<em class="parameter"><code><a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a> *self</code></em>,
 545                                    <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *session_data</code></em>,
 546                                    <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> *mechanism</code></em>,
 547                                    <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
 548                                    <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
 549                                    <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 550 <p>Performs one step of the authentication process.
 551 <em class="parameter"><code>session_data</code></em>
 552  should be used to add additional authentication parameters to the
 553 session.</p>
 554 <p>What specific parameters should be used can be found from authentication plugins'
 555 documentation (look for parameters that are expected in <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/GSignondPlugin.html#gsignond-plugin-request-initial"><code class="function">gsignond_plugin_request_initial()</code></a>
 556 for the first step, and parameters that are expected in <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/GSignondPlugin.html#gsignond-plugin-request"><code class="function">gsignond_plugin_request()</code></a> for
 557 the subsequent steps). See, for example, <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/GSignondPasswordPlugin.html"><span class="type">GSignondPasswordPlugin</span></a> and <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/GSignondDigestPlugin.html"><span class="type">GSignondDigestPlugin</span></a>.</p>
 558 <p>If the <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> that this session belongs to contains a username and a password,
 559 the daemon will pass them to the authentication plugin, otherwise they should be set directly in
 560 <em class="parameter"><code>session_data</code></em>
 561 . The daemon also passes a list of identity's allowed realms to the plugin,
 562 and they cannot be overriden.</p>
 563 <div class="refsect3">
 564 <a name="id-1.3.3.6.9.9.7"></a><h4>Parameters</h4>
 565 <div class="informaltable"><table width="100%" border="0">
 566 <colgroup>
 567 <col width="150px" class="parameters_name">
 568 <col class="parameters_description">
 569 <col width="200px" class="parameters_annotations">
 570 </colgroup>
 571 <tbody>
 572 <tr>
 573 <td class="parameter_name"><p>self</p></td>
 574 <td class="parameter_description"><p>the <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a>.</p></td>
 575 <td class="parameter_annotations"> </td>
 576 </tr>
 577 <tr>
 578 <td class="parameter_name"><p>session_data</p></td>
 579 <td class="parameter_description"><p> a dictionary of parameters. </p></td>
 580 <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>
 581 </tr>
 582 <tr>
 583 <td class="parameter_name"><p>mechanism</p></td>
 584 <td class="parameter_description"><p>the authentication mechanism to be used.</p></td>
 585 <td class="parameter_annotations"> </td>
 586 </tr>
 587 <tr>
 588 <td class="parameter_name"><p>cancellable</p></td>
 589 <td class="parameter_description"><p> optional <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </p></td>
 590 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
 591 </tr>
 592 <tr>
 593 <td class="parameter_name"><p>callback</p></td>
 594 <td class="parameter_description"><p> a callback which will be called when the
 595 authentication reply is available. </p></td>
 596 <td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td>
 597 </tr>
 598 <tr>
 599 <td class="parameter_name"><p>user_data</p></td>
 600 <td class="parameter_description"><p>user data to be passed to the callback.</p></td>
 601 <td class="parameter_annotations"> </td>
 602 </tr>
 603 </tbody>
 604 </table></div>
 605 </div>
 606 <p class="since">Since 1.8</p>
 607 </div>
 608 <hr>
 609 <div class="refsect2">
 610 <a name="signon-auth-session-process-finish"></a><h3>signon_auth_session_process_finish ()</h3>
 611 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
 612 signon_auth_session_process_finish (<em class="parameter"><code><a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a> *self</code></em>,
 613                                     <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *res</code></em>,
 614                                     <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 615 <p>Collect the result of the <a class="link" href="SignonAuthSession.html#signon-auth-session-process-async" title="signon_auth_session_process_async ()"><code class="function">signon_auth_session_process_async()</code></a> operation.</p>
 616 <div class="refsect3">
 617 <a name="id-1.3.3.6.9.10.5"></a><h4>Parameters</h4>
 618 <div class="informaltable"><table width="100%" border="0">
 619 <colgroup>
 620 <col width="150px" class="parameters_name">
 621 <col class="parameters_description">
 622 <col width="200px" class="parameters_annotations">
 623 </colgroup>
 624 <tbody>
 625 <tr>
 626 <td class="parameter_name"><p>self</p></td>
 627 <td class="parameter_description"><p>the <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a>.</p></td>
 628 <td class="parameter_annotations"> </td>
 629 </tr>
 630 <tr>
 631 <td class="parameter_name"><p>res</p></td>
 632 <td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> obtained from the <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> passed to
 633 <a class="link" href="SignonAuthSession.html#signon-auth-session-process-async" title="signon_auth_session_process_async ()"><code class="function">signon_auth_session_process_async()</code></a>.</p></td>
 634 <td class="parameter_annotations"> </td>
 635 </tr>
 636 <tr>
 637 <td class="parameter_name"><p>error</p></td>
 638 <td class="parameter_description"><p>return location for error, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
 639 <td class="parameter_annotations"> </td>
 640 </tr>
 641 </tbody>
 642 </table></div>
 643 </div>
 644 <div class="refsect3">
 645 <a name="id-1.3.3.6.9.10.6"></a><h4>Returns</h4>
 646 <p> a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> of type <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#G-VARIANT-TYPE-VARDICT:CAPS"><code class="literal">G_VARIANT_TYPE_VARDICT</code></a> containing the
 647 authentication reply. As with <a class="link" href="SignonAuthSession.html#signon-auth-session-process-async" title="signon_auth_session_process_async ()"><code class="function">signon_auth_session_process_async()</code></a>, specific
 648 parameters contained in the <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> can be found from plugins' documentation:
 649 <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/GSignondPlugin.html#GSignondPlugin-response-final"><span class="type">“response-final”</span></a> for the final response, and <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/GSignondPlugin.html#GSignondPlugin-response"><span class="type">“response”</span></a>
 650 for the intermediate responses. See, for example, <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/GSignondPasswordPlugin.html"><span class="type">GSignondPasswordPlugin</span></a>
 651 and <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/GSignondDigestPlugin.html"><span class="type">GSignondDigestPlugin</span></a>.</p>
 652 <p></p>
 653 </div>
 654 <p class="since">Since 1.8</p>
 655 </div>
 656 <hr>
 657 <div class="refsect2">
 658 <a name="signon-auth-session-cancel"></a><h3>signon_auth_session_cancel ()</h3>
 659 <pre class="programlisting"><span class="returnvalue">void</span>
 660 signon_auth_session_cancel (<em class="parameter"><code><a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a> *self</code></em>);</pre>
 661 <p>Cancel the authentication session.</p>
 662 <div class="refsect3">
 663 <a name="id-1.3.3.6.9.11.5"></a><h4>Parameters</h4>
 664 <div class="informaltable"><table width="100%" border="0">
 665 <colgroup>
 666 <col width="150px" class="parameters_name">
 667 <col class="parameters_description">
 668 <col width="200px" class="parameters_annotations">
 669 </colgroup>
 670 <tbody><tr>
 671 <td class="parameter_name"><p>self</p></td>
 672 <td class="parameter_description"><p>the <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a>.</p></td>
 673 <td class="parameter_annotations"> </td>
 674 </tr></tbody>
 675 </table></div>
 676 </div>
 677 </div>
 678 </div>
 679 <div class="refsect1">
 680 <a name="SignonAuthSession.other_details"></a><h2>Types and Values</h2>
 681 <div class="refsect2">
 682 <a name="SIGNON-SESSION-DATA-USERNAME:CAPS"></a><h3>SIGNON_SESSION_DATA_USERNAME</h3>
 683 <pre class="programlisting">#define SIGNON_SESSION_DATA_USERNAME      "UserName"
 684 </pre>
 685 <p>Username.</p>
 686 </div>
 687 <hr>
 688 <div class="refsect2">
 689 <a name="SIGNON-SESSION-DATA-SECRET:CAPS"></a><h3>SIGNON_SESSION_DATA_SECRET</h3>
 690 <pre class="programlisting">#define SIGNON_SESSION_DATA_SECRET        "Secret"
 691 </pre>
 692 <p>Secret.</p>
 693 </div>
 694 <hr>
 695 <div class="refsect2">
 696 <a name="SIGNON-SESSION-DATA-REALM:CAPS"></a><h3>SIGNON_SESSION_DATA_REALM</h3>
 697 <pre class="programlisting">#define SIGNON_SESSION_DATA_REALM         "Realm"
 698 </pre>
 699 <p>Realm.</p>
 700 </div>
 701 <hr>
 702 <div class="refsect2">
 703 <a name="SIGNON-SESSION-DATA-PROXY:CAPS"></a><h3>SIGNON_SESSION_DATA_PROXY</h3>
 704 <pre class="programlisting">#define SIGNON_SESSION_DATA_PROXY         "NetworkProxy"
 705 </pre>
 706 <p>Proxy.</p>
 707 </div>
 708 <hr>
 709 <div class="refsect2">
 710 <a name="SignonSessionDataUiPolicy"></a><h3>enum SignonSessionDataUiPolicy</h3>
 711 <p>UI policy for the signon process, passed to the UI plugin.</p>
 712 <div class="refsect3">
 713 <a name="id-1.3.3.6.10.6.4"></a><h4>Members</h4>
 714 <div class="informaltable"><table width="100%" border="0">
 715 <colgroup>
 716 <col width="300px" class="enum_members_name">
 717 <col class="enum_members_description">
 718 <col width="200px" class="enum_members_annotations">
 719 </colgroup>
 720 <tbody>
 721 <tr>
 722 <td class="enum_member_name"><p><a name="SIGNON-POLICY-DEFAULT:CAPS"></a>SIGNON_POLICY_DEFAULT</p></td>
 723 <td class="enum_member_description">
 724 <p>The plugin can decide when to show UI.</p>
 725 </td>
 726 <td class="enum_member_annotations"> </td>
 727 </tr>
 728 <tr>
 729 <td class="enum_member_name"><p><a name="SIGNON-POLICY-REQUEST-PASSWORD:CAPS"></a>SIGNON_POLICY_REQUEST_PASSWORD</p></td>
 730 <td class="enum_member_description">
 731 <p>Force the user to enter the password.</p>
 732 </td>
 733 <td class="enum_member_annotations"> </td>
 734 </tr>
 735 <tr>
 736 <td class="enum_member_name"><p><a name="SIGNON-POLICY-NO-USER-INTERACTION:CAPS"></a>SIGNON_POLICY_NO_USER_INTERACTION</p></td>
 737 <td class="enum_member_description">
 738 <p>No UI elements will be shown to the user.</p>
 739 </td>
 740 <td class="enum_member_annotations"> </td>
 741 </tr>
 742 <tr>
 743 <td class="enum_member_name"><p><a name="SIGNON-POLICY-VALIDATION:CAPS"></a>SIGNON_POLICY_VALIDATION</p></td>
 744 <td class="enum_member_description">
 745 <p>UI elements can be shown to the user only when
 746 CAPTCHA-like security measures are required.</p>
 747 </td>
 748 <td class="enum_member_annotations"> </td>
 749 </tr>
 750 </tbody>
 751 </table></div>
 752 </div>
 753 </div>
 754 <hr>
 755 <div class="refsect2">
 756 <a name="SIGNON-SESSION-DATA-UI-POLICY:CAPS"></a><h3>SIGNON_SESSION_DATA_UI_POLICY</h3>
 757 <pre class="programlisting">#define SIGNON_SESSION_DATA_UI_POLICY     "UiPolicy"
 758 </pre>
 759 <p>Policy for the signon process.</p>
 760 <div class="refsect3">
 761 <a name="id-1.3.3.6.10.7.5"></a><h4>Parameters</h4>
 762 <div class="informaltable"><table width="100%" border="0">
 763 <colgroup>
 764 <col width="150px" class="parameters_name">
 765 <col class="parameters_description">
 766 <col width="200px" class="parameters_annotations">
 767 </colgroup>
 768 <tbody><tr>
 769 <td class="parameter_name"><p>see_also</p></td>
 770 <td class="parameter_description"><p><a class="link" href="SignonAuthSession.html#SignonSessionDataUiPolicy" title="enum SignonSessionDataUiPolicy"><span class="type">SignonSessionDataUiPolicy</span></a></p></td>
 771 <td class="parameter_annotations"> </td>
 772 </tr></tbody>
 773 </table></div>
 774 </div>
 775 </div>
 776 <hr>
 777 <div class="refsect2">
 778 <a name="SIGNON-SESSION-DATA-CAPTION:CAPS"></a><h3>SIGNON_SESSION_DATA_CAPTION</h3>
 779 <pre class="programlisting">#define SIGNON_SESSION_DATA_CAPTION       "Caption"
 780 </pre>
 781 <p>Caption for the UI dialog.</p>
 782 </div>
 783 <hr>
 784 <div class="refsect2">
 785 <a name="SIGNON-SESSION-DATA-TIMEOUT:CAPS"></a><h3>SIGNON_SESSION_DATA_TIMEOUT</h3>
 786 <pre class="programlisting">#define SIGNON_SESSION_DATA_TIMEOUT       "NetworkTimeout"
 787 </pre>
 788 <p>Network timeout, in milliseconds (uint32).</p>
 789 </div>
 790 <hr>
 791 <div class="refsect2">
 792 <a name="SIGNON-SESSION-DATA-WINDOW-ID:CAPS"></a><h3>SIGNON_SESSION_DATA_WINDOW_ID</h3>
 793 <pre class="programlisting">#define SIGNON_SESSION_DATA_WINDOW_ID     "WindowId"
 794 </pre>
 795 <p>Platform-specific window id (for dialog transiency) - uint32.</p>
 796 </div>
 797 <hr>
 798 <div class="refsect2">
 799 <a name="SIGNON-SESSION-DATA-RENEW-TOKEN:CAPS"></a><h3>SIGNON_SESSION_DATA_RENEW_TOKEN</h3>
 800 <pre class="programlisting">#define SIGNON_SESSION_DATA_RENEW_TOKEN   "RenewToken"
 801 </pre>
 802 <p>Requests the signon plugin to obtain a new token (boolean).</p>
 803 </div>
 804 <hr>
 805 <div class="refsect2">
 806 <a name="SignonAuthSession-struct"></a><h3>struct SignonAuthSession</h3>
 807 <pre class="programlisting">struct SignonAuthSession;</pre>
 808 <p>Opaque struct. Use the accessor functions below.</p>
 809 </div>
 810 <hr>
 811 <div class="refsect2">
 812 <a name="SignonAuthSessionClass"></a><h3>struct SignonAuthSessionClass</h3>
 813 <pre class="programlisting">struct SignonAuthSessionClass {
 814     GObjectClass parent;
 815 };
 816 </pre>
 817 <p>Opaque struct. Use the accessor functions below.</p>
 818 <div class="refsect3">
 819 <a name="id-1.3.3.6.10.13.5"></a><h4>Members</h4>
 820 <div class="informaltable"><table width="100%" border="0">
 821 <colgroup>
 822 <col width="300px" class="struct_members_name">
 823 <col class="struct_members_description">
 824 <col width="200px" class="struct_members_annotations">
 825 </colgroup>
 826 <tbody><tr>
 827 <td class="struct_member_name"><p><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> <em class="structfield"><code><a name="SignonAuthSessionClass.parent"></a>parent</code></em>;</p></td>
 828 <td class="struct_member_description"><p>reference to the parent class</p></td>
 829 <td class="struct_member_annotations"> </td>
 830 </tr></tbody>
 831 </table></div>
 832 </div>
 833 </div>
 834 </div>
 835 <div class="refsect1">
 836 <a name="SignonAuthSession.property-details"></a><h2>Property Details</h2>
 837 <div class="refsect2">
 838 <a name="SignonAuthSession--identity"></a><h3>The <code class="literal">“identity”</code> property</h3>
 839 <pre class="programlisting">  “identity”                 <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> *</pre>
 840 <p>Identity Object construct parameter.</p>
 841 <p>Flags: Read / Write / Construct Only</p>
 842 </div>
 843 </div>
 844 <div class="refsect1">
 845 <a name="SignonAuthSession.signal-details"></a><h2>Signal Details</h2>
 846 <div class="refsect2">
 847 <a name="SignonAuthSession-state-changed"></a><h3>The <code class="literal">“state-changed”</code> signal</h3>
 848 <pre class="programlisting"><span class="returnvalue">void</span>
 849 user_function (<a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a> *auth_session,
 850                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>               state,
 851                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>             *message,
 852                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)</pre>
 853 <p>Emitted when the state of the <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a> changes. The state change
 854 is initiated by <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/GSignondPlugin.html"><span class="type">GSignondPlugin</span></a> via <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/GSignondPlugin.html#GSignondPlugin-status-changed"><span class="type">“status-changed”</span></a> signal.</p>
 855 <div class="refsect3">
 856 <a name="id-1.3.3.6.12.2.5"></a><h4>Parameters</h4>
 857 <div class="informaltable"><table width="100%" border="0">
 858 <colgroup>
 859 <col width="150px" class="parameters_name">
 860 <col class="parameters_description">
 861 <col width="200px" class="parameters_annotations">
 862 </colgroup>
 863 <tbody>
 864 <tr>
 865 <td class="parameter_name"><p>auth_session</p></td>
 866 <td class="parameter_description"><p>the <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a></p></td>
 867 <td class="parameter_annotations"> </td>
 868 </tr>
 869 <tr>
 870 <td class="parameter_name"><p>state</p></td>
 871 <td class="parameter_description"><p>the current state of the <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a></p></td>
 872 <td class="parameter_annotations"> </td>
 873 </tr>
 874 <tr>
 875 <td class="parameter_name"><p>message</p></td>
 876 <td class="parameter_description"><p>the message associated with the state change</p></td>
 877 <td class="parameter_annotations"> </td>
 878 </tr>
 879 <tr>
 880 <td class="parameter_name"><p>user_data</p></td>
 881 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
 882 <td class="parameter_annotations"> </td>
 883 </tr>
 884 </tbody>
 885 </table></div>
 886 </div>
 887 <p>Flags: <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></p>
 888 </div>
 889 </div>
 890 </div>
 891 <div class="footer">
 892 <hr>
 893           Generated by GTK-Doc V1.20</div>
 894 </body>
 895 </html>