1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>SignonIdentityInfo</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.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.18 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
17 <td><a accesskey="p" href="SignonIdentity.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="credential-management.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20 <th width="100%" align="center">libgsignon-glib Reference Manual</th>
21 <td><a accesskey="n" href="SignonSecurityContext.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
23 <tr><td colspan="5" class="shortcuts">
24 <a href="#SignonIdentityInfo.synopsis" class="shortcut">Top</a>
26 <a href="#SignonIdentityInfo.description" class="shortcut">Description</a>
28 <a href="#SignonIdentityInfo.object-hierarchy" class="shortcut">Object Hierarchy</a>
31 <div class="refentry">
32 <a name="SignonIdentityInfo"></a><div class="titlepage"></div>
33 <div class="refnamediv"><table width="100%"><tr>
35 <h2><span class="refentrytitle"><a name="SignonIdentityInfo.top_of_page"></a>SignonIdentityInfo</span></h2>
36 <p>SignonIdentityInfo — Extra data for a <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a>.</p>
38 <td valign="top" align="right"></td>
40 <div class="refsynopsisdiv">
41 <a name="SignonIdentityInfo.synopsis"></a><h2>Synopsis</h2>
42 <a name="SignonIdentityType"></a><pre class="synopsis"> <a class="link" href="SignonIdentityInfo.html#SignonIdentityInfo-struct" title="SignonIdentityInfo">SignonIdentityInfo</a>;
43 enum <a class="link" href="SignonIdentityInfo.html#SignonIdentityType-enum" title="enum SignonIdentityType">SignonIdentityType</a>;
44 <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="returnvalue">SignonIdentityInfo</span></a> * <a class="link" href="SignonIdentityInfo.html#signon-identity-info-copy" title="signon_identity_info_copy ()">signon_identity_info_copy</a> (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *other</code></em>);
45 <span class="returnvalue">void</span> <a class="link" href="SignonIdentityInfo.html#signon-identity-info-free" title="signon_identity_info_free ()">signon_identity_info_free</a> (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);
46 const <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="returnvalue">SignonSecurityContextList</span></a> * <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>
47 (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);
48 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="SignonIdentityInfo.html#signon-identity-info-get-caption" title="signon_identity_info_get_caption ()">signon_identity_info_get_caption</a> (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);
49 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> <a class="link" href="SignonIdentityInfo.html#signon-identity-info-get-id" title="signon_identity_info_get_id ()">signon_identity_info_get_id</a> (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);
50 <a class="link" href="SignonIdentityInfo.html#SignonIdentityType"><span class="returnvalue">SignonIdentityType</span></a> <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>
51 (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);
52 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> * <a class="link" href="SignonIdentityInfo.html#signon-identity-info-get-methods" title="signon_identity_info_get_methods ()">signon_identity_info_get_methods</a> (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);
53 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const * <a class="link" href="SignonIdentityInfo.html#signon-identity-info-get-realms" title="signon_identity_info_get_realms ()">signon_identity_info_get_realms</a> (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);
54 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <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>
55 (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);
56 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="SignonIdentityInfo.html#signon-identity-info-get-username" title="signon_identity_info_get_username ()">signon_identity_info_get_username</a> (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);
57 <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="returnvalue">SignonIdentityInfo</span></a> * <a class="link" href="SignonIdentityInfo.html#signon-identity-info-new" title="signon_identity_info_new ()">signon_identity_info_new</a> ();
58 <span class="returnvalue">void</span> <a class="link" href="SignonIdentityInfo.html#signon-identity-info-remove-method" title="signon_identity_info_remove_method ()">signon_identity_info_remove_method</a> (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
59 <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>);
60 <span class="returnvalue">void</span> <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>
61 (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
62 <em class="parameter"><code>const <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a> *access_control_list</code></em>);
63 <span class="returnvalue">void</span> <a class="link" href="SignonIdentityInfo.html#signon-identity-info-set-caption" title="signon_identity_info_set_caption ()">signon_identity_info_set_caption</a> (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
64 <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>);
65 <span class="returnvalue">void</span> <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>
66 (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
67 <em class="parameter"><code><a class="link" href="SignonIdentityInfo.html#SignonIdentityType"><span class="type">SignonIdentityType</span></a> type</code></em>);
68 <span class="returnvalue">void</span> <a class="link" href="SignonIdentityInfo.html#signon-identity-info-set-method" title="signon_identity_info_set_method ()">signon_identity_info_set_method</a> (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
69 <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>,
70 <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>);
71 <span class="returnvalue">void</span> <a class="link" href="SignonIdentityInfo.html#signon-identity-info-set-realms" title="signon_identity_info_set_realms ()">signon_identity_info_set_realms</a> (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
72 <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>);
73 <span class="returnvalue">void</span> <a class="link" href="SignonIdentityInfo.html#signon-identity-info-set-secret" title="signon_identity_info_set_secret ()">signon_identity_info_set_secret</a> (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
74 <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>,
75 <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>);
76 <span class="returnvalue">void</span> <a class="link" href="SignonIdentityInfo.html#signon-identity-info-set-username" title="signon_identity_info_set_username ()">signon_identity_info_set_username</a> (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
77 <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>);
80 <div class="refsect1">
81 <a name="SignonIdentityInfo.object-hierarchy"></a><h2>Object Hierarchy</h2>
82 <pre class="synopsis">
84 +----SignonIdentityInfo
86 <pre class="synopsis">
88 +----SignonIdentityType
91 <div class="refsect1">
92 <a name="SignonIdentityInfo.description"></a><h2>Description</h2>
94 Extra data retreived from a <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a>.
97 <div class="refsect1">
98 <a name="SignonIdentityInfo.details"></a><h2>Details</h2>
99 <div class="refsect2">
100 <a name="SignonIdentityInfo-struct"></a><h3>SignonIdentityInfo</h3>
101 <pre class="programlisting">typedef struct _SignonIdentityInfo SignonIdentityInfo;</pre>
103 Opaque struct. Use the accessor functions below.
107 <div class="refsect2">
108 <a name="SignonIdentityType-enum"></a><h3>enum SignonIdentityType</h3>
109 <pre class="programlisting">typedef enum {
110 SIGNON_IDENTITY_TYPE_OTHER = 0,
111 SIGNON_IDENTITY_TYPE_APP = 1 << 0,
112 SIGNON_IDENTITY_TYPE_WEB = 1 << 1,
113 SIGNON_IDENTITY_TYPE_NETWORK = 1 << 2
114 } SignonIdentityType;
117 Types used in <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.
119 <div class="variablelist"><table border="0">
120 <col align="left" valign="top">
123 <td><p><a name="SIGNON-IDENTITY-TYPE-OTHER:CAPS"></a><span class="term"><code class="literal">SIGNON_IDENTITY_TYPE_OTHER</code></span></p></td>
124 <td>an identity that is not an app, web or network
128 <td><p><a name="SIGNON-IDENTITY-TYPE-APP:CAPS"></a><span class="term"><code class="literal">SIGNON_IDENTITY_TYPE_APP</code></span></p></td>
129 <td>an application identity
133 <td><p><a name="SIGNON-IDENTITY-TYPE-WEB:CAPS"></a><span class="term"><code class="literal">SIGNON_IDENTITY_TYPE_WEB</code></span></p></td>
138 <td><p><a name="SIGNON-IDENTITY-TYPE-NETWORK:CAPS"></a><span class="term"><code class="literal">SIGNON_IDENTITY_TYPE_NETWORK</code></span></p></td>
139 <td>a network server identity
146 <div class="refsect2">
147 <a name="signon-identity-info-copy"></a><h3>signon_identity_info_copy ()</h3>
148 <pre class="programlisting"><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="returnvalue">SignonIdentityInfo</span></a> * 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>
150 Get a newly-allocated copy of <em class="parameter"><code>info</code></em>.
152 <div class="variablelist"><table border="0">
153 <col align="left" valign="top">
156 <td><p><span class="term"><em class="parameter"><code>other</code></em> :</span></p></td>
157 <td>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</td>
160 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
161 <td>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.</td>
167 <div class="refsect2">
168 <a name="signon-identity-info-free"></a><h3>signon_identity_info_free ()</h3>
169 <pre class="programlisting"><span class="returnvalue">void</span> 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>
171 Destroys the given <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> item.
173 <div class="variablelist"><table border="0">
174 <col align="left" valign="top">
176 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
177 <td>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</td>
182 <div class="refsect2">
183 <a name="signon-identity-info-get-access-control-list"></a><h3>signon_identity_info_get_access_control_list ()</h3>
184 <pre class="programlisting">const <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="returnvalue">SignonSecurityContextList</span></a> * signon_identity_info_get_access_control_list
185 (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);</pre>
187 Get an array of ACL statements of the identity.
189 <div class="variablelist"><table border="0">
190 <col align="left" valign="top">
193 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
194 <td>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</td>
197 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
198 <td>a list of ACL security contexts. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
205 <div class="refsect2">
206 <a name="signon-identity-info-get-caption"></a><h3>signon_identity_info_get_caption ()</h3>
207 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 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>
209 Get the display name of <em class="parameter"><code>info</code></em>.
211 <div class="variablelist"><table border="0">
212 <col align="left" valign="top">
215 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
216 <td>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</td>
219 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
220 <td>the display name for the identity.</td>
226 <div class="refsect2">
227 <a name="signon-identity-info-get-id"></a><h3>signon_identity_info_get_id ()</h3>
228 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> 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>
230 Get the numeric ID of <em class="parameter"><code>info</code></em>.
232 <div class="variablelist"><table border="0">
233 <col align="left" valign="top">
236 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
237 <td>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</td>
240 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
241 <td>the numeric ID of the identity.</td>
247 <div class="refsect2">
248 <a name="signon-identity-info-get-identity-type"></a><h3>signon_identity_info_get_identity_type ()</h3>
249 <pre class="programlisting"><a class="link" href="SignonIdentityInfo.html#SignonIdentityType"><span class="returnvalue">SignonIdentityType</span></a> signon_identity_info_get_identity_type
250 (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);</pre>
252 Get the type of the identity.
254 <div class="variablelist"><table border="0">
255 <col align="left" valign="top">
258 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
259 <td>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</td>
262 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
263 <td>the type of the identity.</td>
269 <div class="refsect2">
270 <a name="signon-identity-info-get-methods"></a><h3>signon_identity_info_get_methods ()</h3>
271 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> * 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>
273 Get a hash table of the methods and mechanisms of <em class="parameter"><code>info</code></em>.
275 <div class="variablelist"><table border="0">
276 <col align="left" valign="top">
279 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
280 <td>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</td>
283 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
284 <td>the table of allowed
285 methods and mechanisms. <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 GStrv]</span>
292 <div class="refsect2">
293 <a name="signon-identity-info-get-realms"></a><h3>signon_identity_info_get_realms ()</h3>
294 <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 * 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>
296 Get an array of the realms of <em class="parameter"><code>info</code></em>.
298 <div class="variablelist"><table border="0">
299 <col align="left" valign="top">
302 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
303 <td>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</td>
306 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
307 <td>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. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
314 <div class="refsect2">
315 <a name="signon-identity-info-get-storing-secret"></a><h3>signon_identity_info_get_storing_secret ()</h3>
316 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> signon_identity_info_get_storing_secret
317 (<em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>);</pre>
319 Get whether the secret of <em class="parameter"><code>info</code></em> should be stored.
321 <div class="variablelist"><table border="0">
322 <col align="left" valign="top">
325 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
326 <td>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</td>
329 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
331 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if Signon 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.</td>
337 <div class="refsect2">
338 <a name="signon-identity-info-get-username"></a><h3>signon_identity_info_get_username ()</h3>
339 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 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>
341 Get the username of <em class="parameter"><code>info</code></em>.
343 <div class="variablelist"><table border="0">
344 <col align="left" valign="top">
347 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
348 <td>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</td>
351 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
352 <td>the username, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
358 <div class="refsect2">
359 <a name="signon-identity-info-new"></a><h3>signon_identity_info_new ()</h3>
360 <pre class="programlisting"><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="returnvalue">SignonIdentityInfo</span></a> * signon_identity_info_new ();</pre>
362 Creates a new <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> item.
364 <div class="variablelist"><table border="0">
365 <col align="left" valign="top">
367 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
368 <td>a new <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> item.</td>
373 <div class="refsect2">
374 <a name="signon-identity-info-remove-method"></a><h3>signon_identity_info_remove_method ()</h3>
375 <pre class="programlisting"><span class="returnvalue">void</span> 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>,
376 <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>
378 Remove <em class="parameter"><code>method</code></em> from the list of allowed authentication methods. If all
379 methods are removed, then all methods are allowed.
381 <div class="variablelist"><table border="0">
382 <col align="left" valign="top">
385 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
386 <td>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</td>
389 <td><p><span class="term"><em class="parameter"><code>method</code></em> :</span></p></td>
390 <td>an authentication method.</td>
396 <div class="refsect2">
397 <a name="signon-identity-info-set-access-control-list"></a><h3>signon_identity_info_set_access_control_list ()</h3>
398 <pre class="programlisting"><span class="returnvalue">void</span> signon_identity_info_set_access_control_list
399 (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
400 <em class="parameter"><code>const <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a> *access_control_list</code></em>);</pre>
402 Specifies the ACL for this identity. The actual meaning of the ACL depends
403 on the security framework used by signond. Ownership of the list is trans
405 <div class="variablelist"><table border="0">
406 <col align="left" valign="top">
409 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
410 <td>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</td>
413 <td><p><span class="term"><em class="parameter"><code>access_control_list</code></em> :</span></p></td>
414 <td>(transfer none) a list of ACL security contexts.</td>
420 <div class="refsect2">
421 <a name="signon-identity-info-set-caption"></a><h3>signon_identity_info_set_caption ()</h3>
422 <pre class="programlisting"><span class="returnvalue">void</span> 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>,
423 <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>
425 Sets the caption (display name) for the identity.
427 <div class="variablelist"><table border="0">
428 <col align="left" valign="top">
431 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
432 <td>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</td>
435 <td><p><span class="term"><em class="parameter"><code>caption</code></em> :</span></p></td>
436 <td>the caption.</td>
442 <div class="refsect2">
443 <a name="signon-identity-info-set-identity-type"></a><h3>signon_identity_info_set_identity_type ()</h3>
444 <pre class="programlisting"><span class="returnvalue">void</span> signon_identity_info_set_identity_type
445 (<em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
446 <em class="parameter"><code><a class="link" href="SignonIdentityInfo.html#SignonIdentityType"><span class="type">SignonIdentityType</span></a> type</code></em>);</pre>
448 Specifies the type of this identity.
450 <div class="variablelist"><table border="0">
451 <col align="left" valign="top">
454 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
455 <td>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</td>
458 <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
459 <td>the type of the identity.</td>
465 <div class="refsect2">
466 <a name="signon-identity-info-set-method"></a><h3>signon_identity_info_set_method ()</h3>
467 <pre class="programlisting"><span class="returnvalue">void</span> 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>,
468 <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>,
469 <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>
471 Adds a method to the list of allowed methods.
472 Mechanisms are method-specific functions.
474 <div class="variablelist"><table border="0">
475 <col align="left" valign="top">
478 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
479 <td>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</td>
482 <td><p><span class="term"><em class="parameter"><code>method</code></em> :</span></p></td>
483 <td>an authentication method.</td>
486 <td><p><span class="term"><em class="parameter"><code>mechanisms</code></em> :</span></p></td>
487 <td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-termianted list of mechanisms.</td>
493 <div class="refsect2">
494 <a name="signon-identity-info-set-realms"></a><h3>signon_identity_info_set_realms ()</h3>
495 <pre class="programlisting"><span class="returnvalue">void</span> 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>,
496 <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>
498 Specify what realms this identity can be used in.
500 <div class="variablelist"><table border="0">
501 <col align="left" valign="top">
504 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
505 <td>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</td>
508 <td><p><span class="term"><em class="parameter"><code>realms</code></em> :</span></p></td>
509 <td>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.</td>
515 <div class="refsect2">
516 <a name="signon-identity-info-set-secret"></a><h3>signon_identity_info_set_secret ()</h3>
517 <pre class="programlisting"><span class="returnvalue">void</span> 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>,
518 <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>,
519 <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>
521 Sets the secret (password) for the identity, and whether the signon daemon
524 <div class="variablelist"><table border="0">
525 <col align="left" valign="top">
528 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
529 <td>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</td>
532 <td><p><span class="term"><em class="parameter"><code>secret</code></em> :</span></p></td>
536 <td><p><span class="term"><em class="parameter"><code>store_secret</code></em> :</span></p></td>
537 <td>whether signond should store the secret in its DB.</td>
543 <div class="refsect2">
544 <a name="signon-identity-info-set-username"></a><h3>signon_identity_info_set_username ()</h3>
545 <pre class="programlisting"><span class="returnvalue">void</span> 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>,
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> *username</code></em>);</pre>
548 Sets the username for the identity.
550 <div class="variablelist"><table border="0">
551 <col align="left" valign="top">
554 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
555 <td>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.</td>
558 <td><p><span class="term"><em class="parameter"><code>username</code></em> :</span></p></td>
559 <td>the username.</td>
568 Generated by GTK-Doc V1.18</div>