~ubuntu-branches/ubuntu/maverick/krb5/maverick

« back to all changes in this revision

Viewing changes to doc/kim/html/group__kim__favorite__identities__reference.html

  • Committer: Bazaar Package Importer
  • Author(s): Sam Hartman
  • Date: 2009-05-07 16:16:34 UTC
  • mfrom: (13.1.7 sid)
  • Revision ID: james.westby@ubuntu.com-20090507161634-xqyk0s9na0le4flj
Tags: 1.7dfsg~beta1-4
When  decrypting the TGS response fails with the subkey, try with the
session key to work around Heimdal bug, Closes: #527353 

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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">
 
6
</head><body>
 
7
<!-- Generated by Doxygen 1.5.3 -->
 
8
<h1>KIM Favorite Identities Documentation</h1>
 
9
<p>
 
10
<h2>Functions</h2>
 
11
<ul>
 
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)" -->
 
23
<div class="memitem">
 
24
<div class="memproto">
 
25
      <table class="memname">
 
26
        <tr>
 
27
          <td class="memname"><a class="el" href="group__kim__types__reference.html#g9e10dd2df80df19496dab049a47514cc">kim_error_t</a> kim_favorite_identities_create           </td>
 
28
          <td>(</td>
 
29
          <td class="paramtype"><a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a> *&nbsp;</td>
 
30
          <td class="paramname"> <em>out_favorite_identities</em>          </td>
 
31
          <td>&nbsp;)&nbsp;</td>
 
32
          <td width="100%"></td>
 
33
        </tr>
 
34
      </table>
 
35
</div>
 
36
<div class="memdoc">
 
37
 
 
38
<p>
 
39
Create a new favorite identities list. 
 
40
<p>
 
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>&nbsp;</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>
 
44
  </table>
 
45
</dl>
 
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>
 
47
 
 
48
</div>
 
49
</div><p>
 
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)" -->
 
51
<div class="memitem">
 
52
<div class="memproto">
 
53
      <table class="memname">
 
54
        <tr>
 
55
          <td class="memname"><a class="el" href="group__kim__types__reference.html#g9e10dd2df80df19496dab049a47514cc">kim_error_t</a> kim_favorite_identities_copy           </td>
 
56
          <td>(</td>
 
57
          <td class="paramtype"><a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a> *&nbsp;</td>
 
58
          <td class="paramname"> <em>out_favorite_identities</em>, </td>
 
59
        </tr>
 
60
        <tr>
 
61
          <td class="paramkey"></td>
 
62
          <td></td>
 
63
          <td class="paramtype"><a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a>&nbsp;</td>
 
64
          <td class="paramname"> <em>in_favorite_identities</em></td><td>&nbsp;</td>
 
65
        </tr>
 
66
        <tr>
 
67
          <td></td>
 
68
          <td>)</td>
 
69
          <td></td><td></td><td width="100%"></td>
 
70
        </tr>
 
71
      </table>
 
72
</div>
 
73
<div class="memdoc">
 
74
 
 
75
<p>
 
76
Copy a favorite identities list. 
 
77
<p>
 
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>&nbsp;</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>&nbsp;</td><td>a favorite identities object. </td></tr>
 
82
  </table>
 
83
</dl>
 
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>
 
85
 
 
86
</div>
 
87
</div><p>
 
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)" -->
 
89
<div class="memitem">
 
90
<div class="memproto">
 
91
      <table class="memname">
 
92
        <tr>
 
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>
 
94
          <td>(</td>
 
95
          <td class="paramtype"><a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a>&nbsp;</td>
 
96
          <td class="paramname"> <em>in_favorite_identities</em>, </td>
 
97
        </tr>
 
98
        <tr>
 
99
          <td class="paramkey"></td>
 
100
          <td></td>
 
101
          <td class="paramtype"><a class="el" href="group__kim__types__reference.html#g709d3d4d2733bc8dc29dcab2e806dd38">kim_count_t</a> *&nbsp;</td>
 
102
          <td class="paramname"> <em>out_number_of_identities</em></td><td>&nbsp;</td>
 
103
        </tr>
 
104
        <tr>
 
105
          <td></td>
 
106
          <td>)</td>
 
107
          <td></td><td></td><td width="100%"></td>
 
108
        </tr>
 
109
      </table>
 
110
</div>
 
111
<div class="memdoc">
 
112
 
 
113
<p>
 
114
Get the number of identities in a favorite identities list. 
 
115
<p>
 
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>&nbsp;</td><td>a favorite identities object. </td></tr>
 
119
    <tr><td valign="top"></td><td valign="top"><em>out_number_of_identities</em>&nbsp;</td><td>on exit, the number of identities in <em>in_favorite_identities</em>. </td></tr>
 
120
  </table>
 
121
</dl>
 
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>
 
123
 
 
124
</div>
 
125
</div><p>
 
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">
 
130
        <tr>
 
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>
 
132
          <td>(</td>
 
133
          <td class="paramtype"><a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a>&nbsp;</td>
 
134
          <td class="paramname"> <em>in_favorite_identities</em>, </td>
 
135
        </tr>
 
136
        <tr>
 
137
          <td class="paramkey"></td>
 
138
          <td></td>
 
139
          <td class="paramtype"><a class="el" href="group__kim__types__reference.html#g709d3d4d2733bc8dc29dcab2e806dd38">kim_count_t</a>&nbsp;</td>
 
140
          <td class="paramname"> <em>in_index</em>, </td>
 
141
        </tr>
 
142
        <tr>
 
143
          <td class="paramkey"></td>
 
144
          <td></td>
 
145
          <td class="paramtype"><a class="el" href="group__kim__types__reference.html#g24e6b0e3dab12f058c4b2f08113e772a">kim_identity_t</a> *&nbsp;</td>
 
146
          <td class="paramname"> <em>out_identity</em></td><td>&nbsp;</td>
 
147
        </tr>
 
148
        <tr>
 
149
          <td></td>
 
150
          <td>)</td>
 
151
          <td></td><td></td><td width="100%"></td>
 
152
        </tr>
 
153
      </table>
 
154
</div>
 
155
<div class="memdoc">
 
156
 
 
157
<p>
 
158
Get the Nth identity in a favorite identities list. 
 
159
<p>
 
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>&nbsp;</td><td>a favorite identities object. </td></tr>
 
163
    <tr><td valign="top"></td><td valign="top"><em>in_index</em>&nbsp;</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>&nbsp;</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>
 
165
  </table>
 
166
</dl>
 
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>
 
168
 
 
169
</div>
 
170
</div><p>
 
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">
 
175
        <tr>
 
176
          <td class="memname"><a class="el" href="group__kim__types__reference.html#g9e10dd2df80df19496dab049a47514cc">kim_error_t</a> kim_favorite_identities_add_identity           </td>
 
177
          <td>(</td>
 
178
          <td class="paramtype"><a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a>&nbsp;</td>
 
179
          <td class="paramname"> <em>io_favorite_identities</em>, </td>
 
180
        </tr>
 
181
        <tr>
 
182
          <td class="paramkey"></td>
 
183
          <td></td>
 
184
          <td class="paramtype"><a class="el" href="group__kim__types__reference.html#g24e6b0e3dab12f058c4b2f08113e772a">kim_identity_t</a>&nbsp;</td>
 
185
          <td class="paramname"> <em>in_identity</em></td><td>&nbsp;</td>
 
186
        </tr>
 
187
        <tr>
 
188
          <td></td>
 
189
          <td>)</td>
 
190
          <td></td><td></td><td width="100%"></td>
 
191
        </tr>
 
192
      </table>
 
193
</div>
 
194
<div class="memdoc">
 
195
 
 
196
<p>
 
197
Add an identity to a favorite identities list. 
 
198
<p>
 
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>&nbsp;</td><td>a favorite identities object. </td></tr>
 
202
    <tr><td valign="top"></td><td valign="top"><em>in_identity</em>&nbsp;</td><td>an identity string to add to <em>in_favorite_identities</em>. </td></tr>
 
203
  </table>
 
204
</dl>
 
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>
 
206
 
 
207
</div>
 
208
</div><p>
 
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">
 
213
        <tr>
 
214
          <td class="memname"><a class="el" href="group__kim__types__reference.html#g9e10dd2df80df19496dab049a47514cc">kim_error_t</a> kim_favorite_identities_remove_identity           </td>
 
215
          <td>(</td>
 
216
          <td class="paramtype"><a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a>&nbsp;</td>
 
217
          <td class="paramname"> <em>io_favorite_identities</em>, </td>
 
218
        </tr>
 
219
        <tr>
 
220
          <td class="paramkey"></td>
 
221
          <td></td>
 
222
          <td class="paramtype"><a class="el" href="group__kim__types__reference.html#g24e6b0e3dab12f058c4b2f08113e772a">kim_identity_t</a>&nbsp;</td>
 
223
          <td class="paramname"> <em>in_identity</em></td><td>&nbsp;</td>
 
224
        </tr>
 
225
        <tr>
 
226
          <td></td>
 
227
          <td>)</td>
 
228
          <td></td><td></td><td width="100%"></td>
 
229
        </tr>
 
230
      </table>
 
231
</div>
 
232
<div class="memdoc">
 
233
 
 
234
<p>
 
235
Remove an identity from a identities list. 
 
236
<p>
 
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>&nbsp;</td><td>a favorite identities object. </td></tr>
 
240
    <tr><td valign="top"></td><td valign="top"><em>in_identity</em>&nbsp;</td><td>an identity to remove from <em>in_favorite_identities</em>. </td></tr>
 
241
  </table>
 
242
</dl>
 
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>
 
244
 
 
245
</div>
 
246
</div><p>
 
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">
 
251
        <tr>
 
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>
 
253
          <td>(</td>
 
254
          <td class="paramtype"><a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a>&nbsp;</td>
 
255
          <td class="paramname"> <em>io_favorite_identities</em>          </td>
 
256
          <td>&nbsp;)&nbsp;</td>
 
257
          <td width="100%"></td>
 
258
        </tr>
 
259
      </table>
 
260
</div>
 
261
<div class="memdoc">
 
262
 
 
263
<p>
 
264
Empty a favorite identities list. 
 
265
<p>
 
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>&nbsp;</td><td>a favorite identities object. </td></tr>
 
269
  </table>
 
270
</dl>
 
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>
 
272
 
 
273
</div>
 
274
</div><p>
 
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">
 
279
        <tr>
 
280
          <td class="memname">void kim_favorite_identities_free           </td>
 
281
          <td>(</td>
 
282
          <td class="paramtype"><a class="el" href="group__kim__types__reference.html#g732f9e24fe1281aa42ffa2b078a53282">kim_favorite_identities_t</a> *&nbsp;</td>
 
283
          <td class="paramname"> <em>io_favorite_identities</em>          </td>
 
284
          <td>&nbsp;)&nbsp;</td>
 
285
          <td width="100%"></td>
 
286
        </tr>
 
287
      </table>
 
288
</div>
 
289
<div class="memdoc">
 
290
 
 
291
<p>
 
292
Free memory associated with an identities list. 
 
293
<p>
 
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>&nbsp;</td><td>the favorite identities object to be freed. Set to NULL on exit. </td></tr>
 
297
  </table>
 
298
</dl>
 
299
 
 
300
</div>
 
301
</div><p>
 
302
<hr size="1"><address style="text-align: right;"><small>Generated on Wed May 7 15:22:20 2008 for Kerberos Identity Management by&nbsp;
 
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>
 
305
</body>
 
306
</html>