1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
3
<title>Kerberos Identity Management: KIM Favorite Identities Documentation</title>
4
<link href="doxygen.css" rel="stylesheet" type="text/css">
5
<link href="tabs.css" rel="stylesheet" type="text/css">
7
<!-- Generated by Doxygen 1.5.3 -->
8
<h1>KIM Favorite Identities Documentation</h1>
12
<li><a class="el" href="group__kim__types__reference.html#g9e10dd2df80df19496dab049a47514cc">kim_error_t</a> <a class="el" href="group__kim__favorite__identities__reference.html#gce53e4a9c9edb531a9e7e26c37e0a5ea">kim_favorite_identities_create</a> (<a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a> *out_favorite_identities)
13
<dl class="el"><dd class="mdescRight">Create a new favorite identities list. <a href="#gce53e4a9c9edb531a9e7e26c37e0a5ea"></a><br></dl><li><a class="el" href="group__kim__types__reference.html#g9e10dd2df80df19496dab049a47514cc">kim_error_t</a> <a class="el" href="group__kim__favorite__identities__reference.html#g10c6d3516334f6869539972d289f5f6b">kim_favorite_identities_copy</a> (<a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a> *out_favorite_identities, <a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a> in_favorite_identities)
14
<dl class="el"><dd class="mdescRight">Copy a favorite identities list. <a href="#g10c6d3516334f6869539972d289f5f6b"></a><br></dl><li><a class="el" href="group__kim__types__reference.html#g9e10dd2df80df19496dab049a47514cc">kim_error_t</a> <a class="el" href="group__kim__favorite__identities__reference.html#g122519ef11a212852a6045f3f1929fdb">kim_favorite_identities_get_number_of_identities</a> (<a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a> in_favorite_identities, <a class="el" href="group__kim__types__reference.html#g709d3d4d2733bc8dc29dcab2e806dd38">kim_count_t</a> *out_number_of_identities)
15
<dl class="el"><dd class="mdescRight">Get the number of identities in a favorite identities list. <a href="#g122519ef11a212852a6045f3f1929fdb"></a><br></dl><li><a class="el" href="group__kim__types__reference.html#g9e10dd2df80df19496dab049a47514cc">kim_error_t</a> <a class="el" href="group__kim__favorite__identities__reference.html#gac6ce0a4eaa521fe77b7ae0dbe5097b9">kim_favorite_identities_get_identity_at_index</a> (<a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a> in_favorite_identities, <a class="el" href="group__kim__types__reference.html#g709d3d4d2733bc8dc29dcab2e806dd38">kim_count_t</a> in_index, <a class="el" href="group__kim__types__reference.html#g24e6b0e3dab12f058c4b2f08113e772a">kim_identity_t</a> *out_identity)
16
<dl class="el"><dd class="mdescRight">Get the Nth identity in a favorite identities list. <a href="#gac6ce0a4eaa521fe77b7ae0dbe5097b9"></a><br></dl><li><a class="el" href="group__kim__types__reference.html#g9e10dd2df80df19496dab049a47514cc">kim_error_t</a> <a class="el" href="group__kim__favorite__identities__reference.html#gb298ff23c6e8363d0d34b4c9fdb986e3">kim_favorite_identities_add_identity</a> (<a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a> io_favorite_identities, <a class="el" href="group__kim__types__reference.html#g24e6b0e3dab12f058c4b2f08113e772a">kim_identity_t</a> in_identity)
17
<dl class="el"><dd class="mdescRight">Add an identity to a favorite identities list. <a href="#gb298ff23c6e8363d0d34b4c9fdb986e3"></a><br></dl><li><a class="el" href="group__kim__types__reference.html#g9e10dd2df80df19496dab049a47514cc">kim_error_t</a> <a class="el" href="group__kim__favorite__identities__reference.html#g30b32603f1fa3c1fbb275682620c5d83">kim_favorite_identities_remove_identity</a> (<a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a> io_favorite_identities, <a class="el" href="group__kim__types__reference.html#g24e6b0e3dab12f058c4b2f08113e772a">kim_identity_t</a> in_identity)
18
<dl class="el"><dd class="mdescRight">Remove an identity from a identities list. <a href="#g30b32603f1fa3c1fbb275682620c5d83"></a><br></dl><li><a class="el" href="group__kim__types__reference.html#g9e10dd2df80df19496dab049a47514cc">kim_error_t</a> <a class="el" href="group__kim__favorite__identities__reference.html#g502923d5a9891fb0bb6b75506ce5a8d1">kim_favorite_identities_remove_all_identities</a> (<a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a> io_favorite_identities)
19
<dl class="el"><dd class="mdescRight">Empty a favorite identities list. <a href="#g502923d5a9891fb0bb6b75506ce5a8d1"></a><br></dl><li>void <a class="el" href="group__kim__favorite__identities__reference.html#gd4f899dee1067c58f349c6474300c533">kim_favorite_identities_free</a> (<a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a> *io_favorite_identities)
20
<dl class="el"><dd class="mdescRight">Free memory associated with an identities list. <a href="#gd4f899dee1067c58f349c6474300c533"></a><br></dl></ul>
21
<hr><h2>Function Documentation</h2>
22
<a class="anchor" name="gce53e4a9c9edb531a9e7e26c37e0a5ea"></a><!-- doxytag: member="kim_preferences.h::kim_favorite_identities_create" ref="gce53e4a9c9edb531a9e7e26c37e0a5ea" args="(kim_favorite_identities_t *out_favorite_identities)" -->
24
<div class="memproto">
25
<table class="memname">
27
<td class="memname"><a class="el" href="group__kim__types__reference.html#g9e10dd2df80df19496dab049a47514cc">kim_error_t</a> kim_favorite_identities_create </td>
29
<td class="paramtype"><a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a> * </td>
30
<td class="paramname"> <em>out_favorite_identities</em> </td>
31
<td> ) </td>
32
<td width="100%"></td>
39
Create a new favorite identities list.
41
<dl compact><dt><b>Parameters:</b></dt><dd>
42
<table border="0" cellspacing="2" cellpadding="0">
43
<tr><td valign="top"></td><td valign="top"><em>out_favorite_identities</em> </td><td>on exit, a new favorite identities object. Must be freed with <a class="el" href="group__kim__favorite__identities__reference.html#gd4f899dee1067c58f349c6474300c533" title="Free memory associated with an identities list.">kim_favorite_identities_free()</a>. </td></tr>
46
<dl class="return" compact><dt><b>Returns:</b></dt><dd>On success, <a class="el" href="group__kim__types__reference.html#g8712727bab9e6b02712a8a01285441d1">KIM_NO_ERROR</a>. On failure, an error object representing the failure. </dd></dl>
50
<a class="anchor" name="g10c6d3516334f6869539972d289f5f6b"></a><!-- doxytag: member="kim_preferences.h::kim_favorite_identities_copy" ref="g10c6d3516334f6869539972d289f5f6b" args="(kim_favorite_identities_t *out_favorite_identities, kim_favorite_identities_t in_favorite_identities)" -->
52
<div class="memproto">
53
<table class="memname">
55
<td class="memname"><a class="el" href="group__kim__types__reference.html#g9e10dd2df80df19496dab049a47514cc">kim_error_t</a> kim_favorite_identities_copy </td>
57
<td class="paramtype"><a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a> * </td>
58
<td class="paramname"> <em>out_favorite_identities</em>, </td>
61
<td class="paramkey"></td>
63
<td class="paramtype"><a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a> </td>
64
<td class="paramname"> <em>in_favorite_identities</em></td><td> </td>
69
<td></td><td></td><td width="100%"></td>
76
Copy a favorite identities list.
78
<dl compact><dt><b>Parameters:</b></dt><dd>
79
<table border="0" cellspacing="2" cellpadding="0">
80
<tr><td valign="top"></td><td valign="top"><em>out_favorite_identities</em> </td><td>on exit, a new favorite identities object which is a copy of in_favorite_identities. Must be freed with <a class="el" href="group__kim__favorite__identities__reference.html#gd4f899dee1067c58f349c6474300c533" title="Free memory associated with an identities list.">kim_favorite_identities_free()</a>. </td></tr>
81
<tr><td valign="top"></td><td valign="top"><em>in_favorite_identities</em> </td><td>a favorite identities object. </td></tr>
84
<dl class="return" compact><dt><b>Returns:</b></dt><dd>On success, <a class="el" href="group__kim__types__reference.html#g8712727bab9e6b02712a8a01285441d1">KIM_NO_ERROR</a>. On failure, an error object representing the failure. </dd></dl>
88
<a class="anchor" name="g122519ef11a212852a6045f3f1929fdb"></a><!-- doxytag: member="kim_preferences.h::kim_favorite_identities_get_number_of_identities" ref="g122519ef11a212852a6045f3f1929fdb" args="(kim_favorite_identities_t in_favorite_identities, kim_count_t *out_number_of_identities)" -->
90
<div class="memproto">
91
<table class="memname">
93
<td class="memname"><a class="el" href="group__kim__types__reference.html#g9e10dd2df80df19496dab049a47514cc">kim_error_t</a> kim_favorite_identities_get_number_of_identities </td>
95
<td class="paramtype"><a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a> </td>
96
<td class="paramname"> <em>in_favorite_identities</em>, </td>
99
<td class="paramkey"></td>
101
<td class="paramtype"><a class="el" href="group__kim__types__reference.html#g709d3d4d2733bc8dc29dcab2e806dd38">kim_count_t</a> * </td>
102
<td class="paramname"> <em>out_number_of_identities</em></td><td> </td>
107
<td></td><td></td><td width="100%"></td>
114
Get the number of identities in a favorite identities list.
116
<dl compact><dt><b>Parameters:</b></dt><dd>
117
<table border="0" cellspacing="2" cellpadding="0">
118
<tr><td valign="top"></td><td valign="top"><em>in_favorite_identities</em> </td><td>a favorite identities object. </td></tr>
119
<tr><td valign="top"></td><td valign="top"><em>out_number_of_identities</em> </td><td>on exit, the number of identities in <em>in_favorite_identities</em>. </td></tr>
122
<dl class="return" compact><dt><b>Returns:</b></dt><dd>On success, <a class="el" href="group__kim__types__reference.html#g8712727bab9e6b02712a8a01285441d1">KIM_NO_ERROR</a>. On failure, an error object representing the failure. </dd></dl>
126
<a class="anchor" name="gac6ce0a4eaa521fe77b7ae0dbe5097b9"></a><!-- doxytag: member="kim_preferences.h::kim_favorite_identities_get_identity_at_index" ref="gac6ce0a4eaa521fe77b7ae0dbe5097b9" args="(kim_favorite_identities_t in_favorite_identities, kim_count_t in_index, kim_identity_t *out_identity)" -->
127
<div class="memitem">
128
<div class="memproto">
129
<table class="memname">
131
<td class="memname"><a class="el" href="group__kim__types__reference.html#g9e10dd2df80df19496dab049a47514cc">kim_error_t</a> kim_favorite_identities_get_identity_at_index </td>
133
<td class="paramtype"><a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a> </td>
134
<td class="paramname"> <em>in_favorite_identities</em>, </td>
137
<td class="paramkey"></td>
139
<td class="paramtype"><a class="el" href="group__kim__types__reference.html#g709d3d4d2733bc8dc29dcab2e806dd38">kim_count_t</a> </td>
140
<td class="paramname"> <em>in_index</em>, </td>
143
<td class="paramkey"></td>
145
<td class="paramtype"><a class="el" href="group__kim__types__reference.html#g24e6b0e3dab12f058c4b2f08113e772a">kim_identity_t</a> * </td>
146
<td class="paramname"> <em>out_identity</em></td><td> </td>
151
<td></td><td></td><td width="100%"></td>
158
Get the Nth identity in a favorite identities list.
160
<dl compact><dt><b>Parameters:</b></dt><dd>
161
<table border="0" cellspacing="2" cellpadding="0">
162
<tr><td valign="top"></td><td valign="top"><em>in_favorite_identities</em> </td><td>a favorite identities object. </td></tr>
163
<tr><td valign="top"></td><td valign="top"><em>in_index</em> </td><td>a index into the identities list (starting at 0). </td></tr>
164
<tr><td valign="top"></td><td valign="top"><em>out_realm</em> </td><td>on exit, the identity at <em>in_index</em> in <em>in_favorite_identities</em>. Must be freed with <a class="el" href="group__kim__string__reference.html#ga3e9ac5bcab38b089adfeebd8ba56ded" title="Free memory associated with a string.">kim_string_free()</a>. </td></tr>
167
<dl class="return" compact><dt><b>Returns:</b></dt><dd>On success, <a class="el" href="group__kim__types__reference.html#g8712727bab9e6b02712a8a01285441d1">KIM_NO_ERROR</a>. On failure, an error object representing the failure. </dd></dl>
171
<a class="anchor" name="gb298ff23c6e8363d0d34b4c9fdb986e3"></a><!-- doxytag: member="kim_preferences.h::kim_favorite_identities_add_identity" ref="gb298ff23c6e8363d0d34b4c9fdb986e3" args="(kim_favorite_identities_t io_favorite_identities, kim_identity_t in_identity)" -->
172
<div class="memitem">
173
<div class="memproto">
174
<table class="memname">
176
<td class="memname"><a class="el" href="group__kim__types__reference.html#g9e10dd2df80df19496dab049a47514cc">kim_error_t</a> kim_favorite_identities_add_identity </td>
178
<td class="paramtype"><a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a> </td>
179
<td class="paramname"> <em>io_favorite_identities</em>, </td>
182
<td class="paramkey"></td>
184
<td class="paramtype"><a class="el" href="group__kim__types__reference.html#g24e6b0e3dab12f058c4b2f08113e772a">kim_identity_t</a> </td>
185
<td class="paramname"> <em>in_identity</em></td><td> </td>
190
<td></td><td></td><td width="100%"></td>
197
Add an identity to a favorite identities list.
199
<dl compact><dt><b>Parameters:</b></dt><dd>
200
<table border="0" cellspacing="2" cellpadding="0">
201
<tr><td valign="top"></td><td valign="top"><em>io_favorite_identities</em> </td><td>a favorite identities object. </td></tr>
202
<tr><td valign="top"></td><td valign="top"><em>in_identity</em> </td><td>an identity string to add to <em>in_favorite_identities</em>. </td></tr>
205
<dl class="return" compact><dt><b>Returns:</b></dt><dd>On success, <a class="el" href="group__kim__types__reference.html#g8712727bab9e6b02712a8a01285441d1">KIM_NO_ERROR</a>. On failure, an error object representing the failure. </dd></dl>
209
<a class="anchor" name="g30b32603f1fa3c1fbb275682620c5d83"></a><!-- doxytag: member="kim_preferences.h::kim_favorite_identities_remove_identity" ref="g30b32603f1fa3c1fbb275682620c5d83" args="(kim_favorite_identities_t io_favorite_identities, kim_identity_t in_identity)" -->
210
<div class="memitem">
211
<div class="memproto">
212
<table class="memname">
214
<td class="memname"><a class="el" href="group__kim__types__reference.html#g9e10dd2df80df19496dab049a47514cc">kim_error_t</a> kim_favorite_identities_remove_identity </td>
216
<td class="paramtype"><a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a> </td>
217
<td class="paramname"> <em>io_favorite_identities</em>, </td>
220
<td class="paramkey"></td>
222
<td class="paramtype"><a class="el" href="group__kim__types__reference.html#g24e6b0e3dab12f058c4b2f08113e772a">kim_identity_t</a> </td>
223
<td class="paramname"> <em>in_identity</em></td><td> </td>
228
<td></td><td></td><td width="100%"></td>
235
Remove an identity from a identities list.
237
<dl compact><dt><b>Parameters:</b></dt><dd>
238
<table border="0" cellspacing="2" cellpadding="0">
239
<tr><td valign="top"></td><td valign="top"><em>io_favorite_identities</em> </td><td>a favorite identities object. </td></tr>
240
<tr><td valign="top"></td><td valign="top"><em>in_identity</em> </td><td>an identity to remove from <em>in_favorite_identities</em>. </td></tr>
243
<dl class="return" compact><dt><b>Returns:</b></dt><dd>On success, <a class="el" href="group__kim__types__reference.html#g8712727bab9e6b02712a8a01285441d1">KIM_NO_ERROR</a>. On failure, an error object representing the failure. </dd></dl>
247
<a class="anchor" name="g502923d5a9891fb0bb6b75506ce5a8d1"></a><!-- doxytag: member="kim_preferences.h::kim_favorite_identities_remove_all_identities" ref="g502923d5a9891fb0bb6b75506ce5a8d1" args="(kim_favorite_identities_t io_favorite_identities)" -->
248
<div class="memitem">
249
<div class="memproto">
250
<table class="memname">
252
<td class="memname"><a class="el" href="group__kim__types__reference.html#g9e10dd2df80df19496dab049a47514cc">kim_error_t</a> kim_favorite_identities_remove_all_identities </td>
254
<td class="paramtype"><a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a> </td>
255
<td class="paramname"> <em>io_favorite_identities</em> </td>
256
<td> ) </td>
257
<td width="100%"></td>
264
Empty a favorite identities list.
266
<dl compact><dt><b>Parameters:</b></dt><dd>
267
<table border="0" cellspacing="2" cellpadding="0">
268
<tr><td valign="top"></td><td valign="top"><em>io_favorite_identities</em> </td><td>a favorite identities object. </td></tr>
271
<dl class="return" compact><dt><b>Returns:</b></dt><dd>On success, <a class="el" href="group__kim__types__reference.html#g8712727bab9e6b02712a8a01285441d1">KIM_NO_ERROR</a>. On failure, an error object representing the failure. </dd></dl>
275
<a class="anchor" name="gd4f899dee1067c58f349c6474300c533"></a><!-- doxytag: member="kim_preferences.h::kim_favorite_identities_free" ref="gd4f899dee1067c58f349c6474300c533" args="(kim_favorite_identities_t *io_favorite_identities)" -->
276
<div class="memitem">
277
<div class="memproto">
278
<table class="memname">
280
<td class="memname">void kim_favorite_identities_free </td>
282
<td class="paramtype"><a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a> * </td>
283
<td class="paramname"> <em>io_favorite_identities</em> </td>
284
<td> ) </td>
285
<td width="100%"></td>
292
Free memory associated with an identities list.
294
<dl compact><dt><b>Parameters:</b></dt><dd>
295
<table border="0" cellspacing="2" cellpadding="0">
296
<tr><td valign="top"></td><td valign="top"><em>io_favorite_identities</em> </td><td>the favorite identities object to be freed. Set to NULL on exit. </td></tr>
302
<hr size="1"><address style="text-align: right;"><small>Generated on Wed May 7 15:22:20 2008 for Kerberos Identity Management by
303
<a href="http://www.doxygen.org/index.html">
304
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.3 </small></address>