← Back to branch summary

~ubuntu-branches/ubuntu/natty/gnome-keyring/natty

« back to all changes in this revision

Viewing changes to docs/reference/gnome-keyring/html/gnome-keyring-gnome-keyring-keyrings.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2010-02-16 19:00:06 UTC
  • mfrom: (1.1.58 upstream)
  • Revision ID: james.westby@ubuntu.com-20100216190006-cqpnic4zxlkmmi0o
Tags: 2.29.90git20100218-0ubuntu1
Updated to a git snapshot version

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gnome-keyring/html/gnome-keyring-gnome-keyring-keyrings.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>Keyrings</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
7
 
<link rel="home" href="index.html" title="gnome-keyring Reference Manual">
8
 
<link rel="up" href="ch01.html" title="gnome-keyring API Reference">
9
 
<link rel="prev" href="gnome-keyring-gnome-keyring-password.html" title="Simple Password Storage">
10
 
<link rel="next" href="gnome-keyring-gnome-keyring-keyring-info.html" title="Keyring Info">
11
 
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
12
 
<link rel="stylesheet" href="style.css" type="text/css">
13
 
<link rel="chapter" href="ch01.html" title="gnome-keyring API Reference">
14
 
</head>
15
 
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
16
 
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
17
 
<tr valign="middle">
18
 
<td><a accesskey="p" href="gnome-keyring-gnome-keyring-password.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
19
 
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
20
 
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
21
 
<th width="100%" align="center">gnome-keyring Reference Manual</th>
22
 
<td><a accesskey="n" href="gnome-keyring-gnome-keyring-keyring-info.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
23
 
</tr>
24
 
<tr><td colspan="5" class="shortcuts">
25
 
<a href="#gnome-keyring-gnome-keyring-keyrings.synopsis" class="shortcut">Top</a>
26
 
                 | 
27
 
                <a href="#gnome-keyring-gnome-keyring-keyrings.description" class="shortcut">Description</a>
28
 
</td></tr>
29
 
</table>
30
 
<div class="refentry" title="Keyrings">
31
 
<a name="gnome-keyring-gnome-keyring-keyrings"></a><div class="titlepage"></div>
32
 
<div class="refnamediv"><table width="100%"><tr>
33
 
<td valign="top">
34
 
<h2><span class="refentrytitle"><a name="gnome-keyring-gnome-keyring-keyrings.top_of_page"></a>Keyrings</span></h2>
35
 
<p>Keyrings — Listing and managing keyrings</p>
36
 
</td>
37
 
<td valign="top" align="right"></td>
38
 
</tr></table></div>
39
 
<div class="refsynopsisdiv" title="Synopsis">
40
 
<a name="gnome-keyring-gnome-keyring-keyrings.synopsis"></a><h2>Synopsis</h2>
41
 
<pre class="synopsis">
42
 
void                (<a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#GnomeKeyringOperationGetKeyringInfoCallback" title="GnomeKeyringOperationGetKeyringInfoCallback ()">*GnomeKeyringOperationGetKeyringInfoCallback</a>)
43
 
                                                        (<a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a> result,
44
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-keyring-info.html#GnomeKeyringInfo" title="GnomeKeyringInfo">GnomeKeyringInfo</a> *info,
45
 
                                                         <a
46
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
47
 
>gpointer</a> data);
48
 
<a
49
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
50
 
>gpointer</a>            <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-set-default-keyring" title="gnome_keyring_set_default_keyring ()">gnome_keyring_set_default_keyring</a>   (const char *keyring,
51
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-generic-callbacks.html#GnomeKeyringOperationDoneCallback" title="GnomeKeyringOperationDoneCallback ()">GnomeKeyringOperationDoneCallback</a> callback,
52
 
                                                         <a
53
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
54
 
>gpointer</a> data,
55
 
                                                         <a
56
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
57
 
>GDestroyNotify</a> destroy_data);
58
 
<a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-set-default-keyring-sync" title="gnome_keyring_set_default_keyring_sync ()">gnome_keyring_set_default_keyring_sync</a>
59
 
                                                        (const char *keyring);
60
 
<a
61
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
62
 
>gpointer</a>            <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-get-default-keyring" title="gnome_keyring_get_default_keyring ()">gnome_keyring_get_default_keyring</a>   (<a class="link" href="gnome-keyring-gnome-keyring-generic-callbacks.html#GnomeKeyringOperationGetStringCallback" title="GnomeKeyringOperationGetStringCallback ()">GnomeKeyringOperationGetStringCallback</a> callback,
63
 
                                                         <a
64
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
65
 
>gpointer</a> data,
66
 
                                                         <a
67
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
68
 
>GDestroyNotify</a> destroy_data);
69
 
<a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-get-default-keyring-sync" title="gnome_keyring_get_default_keyring_sync ()">gnome_keyring_get_default_keyring_sync</a>
70
 
                                                        (char **keyring);
71
 
<a
72
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
73
 
>gpointer</a>            <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-list-keyring-names" title="gnome_keyring_list_keyring_names ()">gnome_keyring_list_keyring_names</a>    (<a class="link" href="gnome-keyring-gnome-keyring-generic-callbacks.html#GnomeKeyringOperationGetListCallback" title="GnomeKeyringOperationGetListCallback ()">GnomeKeyringOperationGetListCallback</a> callback,
74
 
                                                         <a
75
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
76
 
>gpointer</a> data,
77
 
                                                         <a
78
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
79
 
>GDestroyNotify</a> destroy_data);
80
 
<a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-list-keyring-names-sync" title="gnome_keyring_list_keyring_names_sync ()">gnome_keyring_list_keyring_names_sync</a>
81
 
                                                        (<a
82
 
href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"
83
 
>GList</a> **keyrings);
84
 
<a
85
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
86
 
>gpointer</a>            <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-lock-all" title="gnome_keyring_lock_all ()">gnome_keyring_lock_all</a>              (<a class="link" href="gnome-keyring-gnome-keyring-generic-callbacks.html#GnomeKeyringOperationDoneCallback" title="GnomeKeyringOperationDoneCallback ()">GnomeKeyringOperationDoneCallback</a> callback,
87
 
                                                         <a
88
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
89
 
>gpointer</a> data,
90
 
                                                         <a
91
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
92
 
>GDestroyNotify</a> destroy_data);
93
 
<a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-lock-all-sync" title="gnome_keyring_lock_all_sync ()">gnome_keyring_lock_all_sync</a>         (void);
94
 
<a
95
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
96
 
>gpointer</a>            <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-create" title="gnome_keyring_create ()">gnome_keyring_create</a>                (const char *keyring_name,
97
 
                                                         const char *password,
98
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-generic-callbacks.html#GnomeKeyringOperationDoneCallback" title="GnomeKeyringOperationDoneCallback ()">GnomeKeyringOperationDoneCallback</a> callback,
99
 
                                                         <a
100
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
101
 
>gpointer</a> data,
102
 
                                                         <a
103
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
104
 
>GDestroyNotify</a> destroy_data);
105
 
<a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-create-sync" title="gnome_keyring_create_sync ()">gnome_keyring_create_sync</a>           (const char *keyring_name,
106
 
                                                         const char *password);
107
 
<a
108
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
109
 
>gpointer</a>            <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-unlock" title="gnome_keyring_unlock ()">gnome_keyring_unlock</a>                (const char *keyring,
110
 
                                                         const char *password,
111
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-generic-callbacks.html#GnomeKeyringOperationDoneCallback" title="GnomeKeyringOperationDoneCallback ()">GnomeKeyringOperationDoneCallback</a> callback,
112
 
                                                         <a
113
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
114
 
>gpointer</a> data,
115
 
                                                         <a
116
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
117
 
>GDestroyNotify</a> destroy_data);
118
 
<a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-unlock-sync" title="gnome_keyring_unlock_sync ()">gnome_keyring_unlock_sync</a>           (const char *keyring,
119
 
                                                         const char *password);
120
 
<a
121
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
122
 
>gpointer</a>            <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-lock" title="gnome_keyring_lock ()">gnome_keyring_lock</a>                  (const char *keyring,
123
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-generic-callbacks.html#GnomeKeyringOperationDoneCallback" title="GnomeKeyringOperationDoneCallback ()">GnomeKeyringOperationDoneCallback</a> callback,
124
 
                                                         <a
125
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
126
 
>gpointer</a> data,
127
 
                                                         <a
128
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
129
 
>GDestroyNotify</a> destroy_data);
130
 
<a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-lock-sync" title="gnome_keyring_lock_sync ()">gnome_keyring_lock_sync</a>             (const char *keyring);
131
 
<a
132
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
133
 
>gpointer</a>            <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-delete" title="gnome_keyring_delete ()">gnome_keyring_delete</a>                (const char *keyring,
134
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-generic-callbacks.html#GnomeKeyringOperationDoneCallback" title="GnomeKeyringOperationDoneCallback ()">GnomeKeyringOperationDoneCallback</a> callback,
135
 
                                                         <a
136
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
137
 
>gpointer</a> data,
138
 
                                                         <a
139
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
140
 
>GDestroyNotify</a> destroy_data);
141
 
<a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-delete-sync" title="gnome_keyring_delete_sync ()">gnome_keyring_delete_sync</a>           (const char *keyring);
142
 
<a
143
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
144
 
>gpointer</a>            <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-get-info" title="gnome_keyring_get_info ()">gnome_keyring_get_info</a>              (const char *keyring,
145
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#GnomeKeyringOperationGetKeyringInfoCallback" title="GnomeKeyringOperationGetKeyringInfoCallback ()">GnomeKeyringOperationGetKeyringInfoCallback</a> callback,
146
 
                                                         <a
147
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
148
 
>gpointer</a> data,
149
 
                                                         <a
150
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
151
 
>GDestroyNotify</a> destroy_data);
152
 
<a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-get-info-sync" title="gnome_keyring_get_info_sync ()">gnome_keyring_get_info_sync</a>         (const char *keyring,
153
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-keyring-info.html#GnomeKeyringInfo" title="GnomeKeyringInfo">GnomeKeyringInfo</a> **info);
154
 
<a
155
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
156
 
>gpointer</a>            <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-set-info" title="gnome_keyring_set_info ()">gnome_keyring_set_info</a>              (const char *keyring,
157
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-keyring-info.html#GnomeKeyringInfo" title="GnomeKeyringInfo">GnomeKeyringInfo</a> *info,
158
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-generic-callbacks.html#GnomeKeyringOperationDoneCallback" title="GnomeKeyringOperationDoneCallback ()">GnomeKeyringOperationDoneCallback</a> callback,
159
 
                                                         <a
160
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
161
 
>gpointer</a> data,
162
 
                                                         <a
163
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
164
 
>GDestroyNotify</a> destroy_data);
165
 
<a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-set-info-sync" title="gnome_keyring_set_info_sync ()">gnome_keyring_set_info_sync</a>         (const char *keyring,
166
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-keyring-info.html#GnomeKeyringInfo" title="GnomeKeyringInfo">GnomeKeyringInfo</a> *info);
167
 
<a
168
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
169
 
>gpointer</a>            <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-change-password" title="gnome_keyring_change_password ()">gnome_keyring_change_password</a>       (const char *keyring,
170
 
                                                         const char *original,
171
 
                                                         const char *password,
172
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-generic-callbacks.html#GnomeKeyringOperationDoneCallback" title="GnomeKeyringOperationDoneCallback ()">GnomeKeyringOperationDoneCallback</a> callback,
173
 
                                                         <a
174
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
175
 
>gpointer</a> data,
176
 
                                                         <a
177
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
178
 
>GDestroyNotify</a> destroy_data);
179
 
<a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-change-password-sync" title="gnome_keyring_change_password_sync ()">gnome_keyring_change_password_sync</a>  (const char *keyring,
180
 
                                                         const char *original,
181
 
                                                         const char *password);
182
 
<a
183
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
184
 
>gpointer</a>            <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-list-item-ids" title="gnome_keyring_list_item_ids ()">gnome_keyring_list_item_ids</a>         (const char *keyring,
185
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-generic-callbacks.html#GnomeKeyringOperationGetListCallback" title="GnomeKeyringOperationGetListCallback ()">GnomeKeyringOperationGetListCallback</a> callback,
186
 
                                                         <a
187
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
188
 
>gpointer</a> data,
189
 
                                                         <a
190
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
191
 
>GDestroyNotify</a> destroy_data);
192
 
<a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-list-item-ids-sync" title="gnome_keyring_list_item_ids_sync ()">gnome_keyring_list_item_ids_sync</a>    (const char *keyring,
193
 
                                                         <a
194
 
href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"
195
 
>GList</a> **ids);
196
 
</pre>
197
 
</div>
198
 
<div class="refsect1" title="Description">
199
 
<a name="gnome-keyring-gnome-keyring-keyrings.description"></a><h2>Description</h2>
200
 
<p>
201
 
<code class="literal">gnome</code>-keyring-daemon manages multiple keyrings. Each keyring can store one or more items containing secrets.
202
 
</p>
203
 
<p>
204
 
One of the keyrings is the default keyring, which can in many cases be used by specifying <a
205
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
206
 
><code class="literal">NULL</code></a> for a keyring name.
207
 
</p>
208
 
<p>
209
 
Each keyring can be in a locked or unlocked state. A password must be specified, either by the user or the calling application, to unlock the keyring.</p>
210
 
<p>
211
 
</p>
212
 
</div>
213
 
<div class="refsect1" title="Details">
214
 
<a name="gnome-keyring-gnome-keyring-keyrings.details"></a><h2>Details</h2>
215
 
<div class="refsect2" title="GnomeKeyringOperationGetKeyringInfoCallback ()">
216
 
<a name="GnomeKeyringOperationGetKeyringInfoCallback"></a><h3>GnomeKeyringOperationGetKeyringInfoCallback ()</h3>
217
 
<pre class="programlisting">void                (*GnomeKeyringOperationGetKeyringInfoCallback)
218
 
                                                        (<a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a> result,
219
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-keyring-info.html#GnomeKeyringInfo" title="GnomeKeyringInfo">GnomeKeyringInfo</a> *info,
220
 
                                                         <a
221
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
222
 
>gpointer</a> data);</pre>
223
 
<p>
224
 
</p>
225
 
<div class="variablelist"><table border="0">
226
 
<col align="left" valign="top">
227
 
<tbody>
228
 
<tr>
229
 
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
230
 
<td>
231
 
</td>
232
 
</tr>
233
 
<tr>
234
 
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
235
 
<td>
236
 
</td>
237
 
</tr>
238
 
<tr>
239
 
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
240
 
<td>
241
 
</td>
242
 
</tr>
243
 
</tbody>
244
 
</table></div>
245
 
</div>
246
 
<hr>
247
 
<div class="refsect2" title="gnome_keyring_set_default_keyring ()">
248
 
<a name="gnome-keyring-set-default-keyring"></a><h3>gnome_keyring_set_default_keyring ()</h3>
249
 
<pre class="programlisting"><a
250
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
251
 
>gpointer</a>            gnome_keyring_set_default_keyring   (const char *keyring,
252
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-generic-callbacks.html#GnomeKeyringOperationDoneCallback" title="GnomeKeyringOperationDoneCallback ()">GnomeKeyringOperationDoneCallback</a> callback,
253
 
                                                         <a
254
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
255
 
>gpointer</a> data,
256
 
                                                         <a
257
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
258
 
>GDestroyNotify</a> destroy_data);</pre>
259
 
<p>
260
 
Change the default keyring. 
261
 
</p>
262
 
<p>
263
 
For a synchronous version of this function see <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-set-default-keyring-sync" title="gnome_keyring_set_default_keyring_sync ()"><code class="function">gnome_keyring_set_default_keyring_sync()</code></a>.</p>
264
 
<p>
265
 
</p>
266
 
<div class="variablelist"><table border="0">
267
 
<col align="left" valign="top">
268
 
<tbody>
269
 
<tr>
270
 
<td><p><span class="term"><em class="parameter"><code>keyring</code></em> :</span></p></td>
271
 
<td> The keyring to make default
272
 
</td>
273
 
</tr>
274
 
<tr>
275
 
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
276
 
<td> A callback which will be called when the request completes or fails.
277
 
</td>
278
 
</tr>
279
 
<tr>
280
 
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
281
 
<td> A pointer to arbitrary data that will be passed to the <em class="parameter"><code>callback</code></em>.
282
 
</td>
283
 
</tr>
284
 
<tr>
285
 
<td><p><span class="term"><em class="parameter"><code>destroy_data</code></em> :</span></p></td>
286
 
<td> A function to free <em class="parameter"><code>data</code></em> when it's no longer needed.
287
 
</td>
288
 
</tr>
289
 
<tr>
290
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
291
 
<td> The asychronous request, which can be passed to <a class="link" href="gnome-keyring-gnome-keyring-misc.html#gnome-keyring-cancel-request" title="gnome_keyring_cancel_request ()"><code class="function">gnome_keyring_cancel_request()</code></a>.
292
 
</td>
293
 
</tr>
294
 
</tbody>
295
 
</table></div>
296
 
</div>
297
 
<hr>
298
 
<div class="refsect2" title="gnome_keyring_set_default_keyring_sync ()">
299
 
<a name="gnome-keyring-set-default-keyring-sync"></a><h3>gnome_keyring_set_default_keyring_sync ()</h3>
300
 
<pre class="programlisting"><a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  gnome_keyring_set_default_keyring_sync
301
 
                                                        (const char *keyring);</pre>
302
 
<p>
303
 
Change the default keyring. 
304
 
</p>
305
 
<p>
306
 
For an asynchronous version of this function see <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-set-default-keyring" title="gnome_keyring_set_default_keyring ()"><code class="function">gnome_keyring_set_default_keyring()</code></a>.</p>
307
 
<p>
308
 
</p>
309
 
<div class="variablelist"><table border="0">
310
 
<col align="left" valign="top">
311
 
<tbody>
312
 
<tr>
313
 
<td><p><span class="term"><em class="parameter"><code>keyring</code></em> :</span></p></td>
314
 
<td> The keyring to make default
315
 
</td>
316
 
</tr>
317
 
<tr>
318
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
319
 
<td> <code class="literal">GNOME_KEYRING_RESULT_OK</code> if the operation was succcessful or 
320
 
an error result otherwise.
321
 
</td>
322
 
</tr>
323
 
</tbody>
324
 
</table></div>
325
 
</div>
326
 
<hr>
327
 
<div class="refsect2" title="gnome_keyring_get_default_keyring ()">
328
 
<a name="gnome-keyring-get-default-keyring"></a><h3>gnome_keyring_get_default_keyring ()</h3>
329
 
<pre class="programlisting"><a
330
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
331
 
>gpointer</a>            gnome_keyring_get_default_keyring   (<a class="link" href="gnome-keyring-gnome-keyring-generic-callbacks.html#GnomeKeyringOperationGetStringCallback" title="GnomeKeyringOperationGetStringCallback ()">GnomeKeyringOperationGetStringCallback</a> callback,
332
 
                                                         <a
333
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
334
 
>gpointer</a> data,
335
 
                                                         <a
336
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
337
 
>GDestroyNotify</a> destroy_data);</pre>
338
 
<p>
339
 
Get the default keyring name, which will be passed to the <em class="parameter"><code>callback</code></em>. If no 
340
 
default keyring exists, then <a
341
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
342
 
><code class="literal">NULL</code></a> will be passed to the <em class="parameter"><code>callback</code></em>. The 
343
 
string will be freed after <em class="parameter"><code>callback</code></em> returns.
344
 
</p>
345
 
<p>
346
 
For a synchronous version of this function see <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-get-default-keyring-sync" title="gnome_keyring_get_default_keyring_sync ()"><code class="function">gnome_keyring_get_default_keyring_sync()</code></a>.</p>
347
 
<p>
348
 
</p>
349
 
<div class="variablelist"><table border="0">
350
 
<col align="left" valign="top">
351
 
<tbody>
352
 
<tr>
353
 
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
354
 
<td> A callback which will be called when the request completes or fails.
355
 
</td>
356
 
</tr>
357
 
<tr>
358
 
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
359
 
<td> A pointer to arbitrary data that will be passed to the <em class="parameter"><code>callback</code></em>.
360
 
</td>
361
 
</tr>
362
 
<tr>
363
 
<td><p><span class="term"><em class="parameter"><code>destroy_data</code></em> :</span></p></td>
364
 
<td> A function to free <em class="parameter"><code>data</code></em> when it's no longer needed.
365
 
</td>
366
 
</tr>
367
 
<tr>
368
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
369
 
<td> The asychronous request, which can be passed to <a class="link" href="gnome-keyring-gnome-keyring-misc.html#gnome-keyring-cancel-request" title="gnome_keyring_cancel_request ()"><code class="function">gnome_keyring_cancel_request()</code></a>.
370
 
</td>
371
 
</tr>
372
 
</tbody>
373
 
</table></div>
374
 
</div>
375
 
<hr>
376
 
<div class="refsect2" title="gnome_keyring_get_default_keyring_sync ()">
377
 
<a name="gnome-keyring-get-default-keyring-sync"></a><h3>gnome_keyring_get_default_keyring_sync ()</h3>
378
 
<pre class="programlisting"><a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  gnome_keyring_get_default_keyring_sync
379
 
                                                        (char **keyring);</pre>
380
 
<p>
381
 
Get the default keyring name. 
382
 
</p>
383
 
<p>
384
 
The string returned in <em class="parameter"><code>keyring</code></em> must be freed with <a
385
 
href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"
386
 
><code class="function">g_free()</code></a>. 
387
 
</p>
388
 
<p>
389
 
For an asynchronous version of this function see <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-get-default-keyring" title="gnome_keyring_get_default_keyring ()"><code class="function">gnome_keyring_get_default_keyring()</code></a>.</p>
390
 
<p>
391
 
</p>
392
 
<div class="variablelist"><table border="0">
393
 
<col align="left" valign="top">
394
 
<tbody>
395
 
<tr>
396
 
<td><p><span class="term"><em class="parameter"><code>keyring</code></em> :</span></p></td>
397
 
<td> Location for the default keyring name to be returned.
398
 
</td>
399
 
</tr>
400
 
<tr>
401
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
402
 
<td> <code class="literal">GNOME_KEYRING_RESULT_OK</code> if the operation was succcessful or 
403
 
an error result otherwise.
404
 
</td>
405
 
</tr>
406
 
</tbody>
407
 
</table></div>
408
 
</div>
409
 
<hr>
410
 
<div class="refsect2" title="gnome_keyring_list_keyring_names ()">
411
 
<a name="gnome-keyring-list-keyring-names"></a><h3>gnome_keyring_list_keyring_names ()</h3>
412
 
<pre class="programlisting"><a
413
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
414
 
>gpointer</a>            gnome_keyring_list_keyring_names    (<a class="link" href="gnome-keyring-gnome-keyring-generic-callbacks.html#GnomeKeyringOperationGetListCallback" title="GnomeKeyringOperationGetListCallback ()">GnomeKeyringOperationGetListCallback</a> callback,
415
 
                                                         <a
416
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
417
 
>gpointer</a> data,
418
 
                                                         <a
419
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
420
 
>GDestroyNotify</a> destroy_data);</pre>
421
 
<p>
422
 
Get a list of keyring names. 
423
 
</p>
424
 
<p>
425
 
A <a
426
 
href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"
427
 
><code class="literal">GList</code></a> of null terminated strings will be passed to 
428
 
the <em class="parameter"><code>callback</code></em>. If no keyrings exist then an empty list will be passed to the 
429
 
<em class="parameter"><code>callback</code></em>. The list is freed after <em class="parameter"><code>callback</code></em> returns.
430
 
</p>
431
 
<p>
432
 
For a synchronous version of this function see <code class="function">gnome_keyring_list_keyrings_sync()</code>.</p>
433
 
<p>
434
 
</p>
435
 
<div class="variablelist"><table border="0">
436
 
<col align="left" valign="top">
437
 
<tbody>
438
 
<tr>
439
 
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
440
 
<td> A callback which will be called when the request completes or fails.
441
 
</td>
442
 
</tr>
443
 
<tr>
444
 
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
445
 
<td> A pointer to arbitrary data that will be passed to the <em class="parameter"><code>callback</code></em>.
446
 
</td>
447
 
</tr>
448
 
<tr>
449
 
<td><p><span class="term"><em class="parameter"><code>destroy_data</code></em> :</span></p></td>
450
 
<td> A function to free <em class="parameter"><code>data</code></em> when it's no longer needed.
451
 
</td>
452
 
</tr>
453
 
<tr>
454
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
455
 
<td> The asychronous request, which can be passed to <a class="link" href="gnome-keyring-gnome-keyring-misc.html#gnome-keyring-cancel-request" title="gnome_keyring_cancel_request ()"><code class="function">gnome_keyring_cancel_request()</code></a>.
456
 
</td>
457
 
</tr>
458
 
</tbody>
459
 
</table></div>
460
 
</div>
461
 
<hr>
462
 
<div class="refsect2" title="gnome_keyring_list_keyring_names_sync ()">
463
 
<a name="gnome-keyring-list-keyring-names-sync"></a><h3>gnome_keyring_list_keyring_names_sync ()</h3>
464
 
<pre class="programlisting"><a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  gnome_keyring_list_keyring_names_sync
465
 
                                                        (<a
466
 
href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"
467
 
>GList</a> **keyrings);</pre>
468
 
<p>
469
 
Get a list of keyring names.
470
 
</p>
471
 
<p>
472
 
The list returned in in <em class="parameter"><code>keyrings</code></em> must be freed using 
473
 
<a class="link" href="gnome-keyring-gnome-keyring-misc.html#gnome-keyring-string-list-free" title="gnome_keyring_string_list_free ()"><code class="function">gnome_keyring_string_list_free()</code></a>.
474
 
</p>
475
 
<p>
476
 
For an asynchronous version of this function see <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-list-keyring-names" title="gnome_keyring_list_keyring_names ()"><code class="function">gnome_keyring_list_keyring_names()</code></a>.</p>
477
 
<p>
478
 
</p>
479
 
<div class="variablelist"><table border="0">
480
 
<col align="left" valign="top">
481
 
<tbody>
482
 
<tr>
483
 
<td><p><span class="term"><em class="parameter"><code>keyrings</code></em> :</span></p></td>
484
 
<td> Location for a <a
485
 
href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"
486
 
><code class="literal">GList</code></a> of keyring names to be returned.
487
 
</td>
488
 
</tr>
489
 
<tr>
490
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
491
 
<td> <code class="literal">GNOME_KEYRING_RESULT_OK</code> if the operation was succcessful or 
492
 
an error result otherwise.
493
 
</td>
494
 
</tr>
495
 
</tbody>
496
 
</table></div>
497
 
</div>
498
 
<hr>
499
 
<div class="refsect2" title="gnome_keyring_lock_all ()">
500
 
<a name="gnome-keyring-lock-all"></a><h3>gnome_keyring_lock_all ()</h3>
501
 
<pre class="programlisting"><a
502
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
503
 
>gpointer</a>            gnome_keyring_lock_all              (<a class="link" href="gnome-keyring-gnome-keyring-generic-callbacks.html#GnomeKeyringOperationDoneCallback" title="GnomeKeyringOperationDoneCallback ()">GnomeKeyringOperationDoneCallback</a> callback,
504
 
                                                         <a
505
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
506
 
>gpointer</a> data,
507
 
                                                         <a
508
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
509
 
>GDestroyNotify</a> destroy_data);</pre>
510
 
<p>
511
 
Lock all the keyrings, so that their contents may not be accessed without 
512
 
first unlocking them with a password.
513
 
</p>
514
 
<p>
515
 
For a synchronous version of this function see <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-lock-all-sync" title="gnome_keyring_lock_all_sync ()"><code class="function">gnome_keyring_lock_all_sync()</code></a>.</p>
516
 
<p>
517
 
</p>
518
 
<div class="variablelist"><table border="0">
519
 
<col align="left" valign="top">
520
 
<tbody>
521
 
<tr>
522
 
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
523
 
<td> A callback which will be called when the request completes or fails.
524
 
</td>
525
 
</tr>
526
 
<tr>
527
 
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
528
 
<td> A pointer to arbitrary data that will be passed to the <em class="parameter"><code>callback</code></em>.
529
 
</td>
530
 
</tr>
531
 
<tr>
532
 
<td><p><span class="term"><em class="parameter"><code>destroy_data</code></em> :</span></p></td>
533
 
<td> A function to free <em class="parameter"><code>data</code></em> when it's no longer needed.
534
 
</td>
535
 
</tr>
536
 
<tr>
537
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
538
 
<td> The asychronous request, which can be passed to <a class="link" href="gnome-keyring-gnome-keyring-misc.html#gnome-keyring-cancel-request" title="gnome_keyring_cancel_request ()"><code class="function">gnome_keyring_cancel_request()</code></a>.
539
 
</td>
540
 
</tr>
541
 
</tbody>
542
 
</table></div>
543
 
</div>
544
 
<hr>
545
 
<div class="refsect2" title="gnome_keyring_lock_all_sync ()">
546
 
<a name="gnome-keyring-lock-all-sync"></a><h3>gnome_keyring_lock_all_sync ()</h3>
547
 
<pre class="programlisting"><a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  gnome_keyring_lock_all_sync         (void);</pre>
548
 
<p>
549
 
Lock all the keyrings, so that their contents may not eb accessed without
550
 
first unlocking them with a password.
551
 
</p>
552
 
<p>
553
 
For an asynchronous version of this function see <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-lock-all" title="gnome_keyring_lock_all ()"><code class="function">gnome_keyring_lock_all()</code></a>.</p>
554
 
<p>
555
 
</p>
556
 
<div class="variablelist"><table border="0">
557
 
<col align="left" valign="top">
558
 
<tbody><tr>
559
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
560
 
<td> <code class="literal">GNOME_KEYRING_RESULT_OK</code> if the operation was succcessful or 
561
 
an error result otherwise.
562
 
</td>
563
 
</tr></tbody>
564
 
</table></div>
565
 
</div>
566
 
<hr>
567
 
<div class="refsect2" title="gnome_keyring_create ()">
568
 
<a name="gnome-keyring-create"></a><h3>gnome_keyring_create ()</h3>
569
 
<pre class="programlisting"><a
570
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
571
 
>gpointer</a>            gnome_keyring_create                (const char *keyring_name,
572
 
                                                         const char *password,
573
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-generic-callbacks.html#GnomeKeyringOperationDoneCallback" title="GnomeKeyringOperationDoneCallback ()">GnomeKeyringOperationDoneCallback</a> callback,
574
 
                                                         <a
575
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
576
 
>gpointer</a> data,
577
 
                                                         <a
578
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
579
 
>GDestroyNotify</a> destroy_data);</pre>
580
 
<p>
581
 
Create a new keyring with the specified name. In most cases <a
582
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
583
 
><code class="literal">NULL</code></a> will be 
584
 
passed as the <em class="parameter"><code>password</code></em>, which will prompt the user to enter a password
585
 
of their choice. 
586
 
</p>
587
 
<p>
588
 
For a synchronous version of this function see <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-create-sync" title="gnome_keyring_create_sync ()"><code class="function">gnome_keyring_create_sync()</code></a>.</p>
589
 
<p>
590
 
</p>
591
 
<div class="variablelist"><table border="0">
592
 
<col align="left" valign="top">
593
 
<tbody>
594
 
<tr>
595
 
<td><p><span class="term"><em class="parameter"><code>keyring_name</code></em> :</span></p></td>
596
 
<td> The new keyring name. Must not be <a
597
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
598
 
><code class="literal">NULL</code></a>.
599
 
</td>
600
 
</tr>
601
 
<tr>
602
 
<td><p><span class="term"><em class="parameter"><code>password</code></em> :</span></p></td>
603
 
<td> The password for the new keyring. If <a
604
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
605
 
><code class="literal">NULL</code></a> user will be prompted.
606
 
</td>
607
 
</tr>
608
 
<tr>
609
 
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
610
 
<td> A callback which will be called when the request completes or fails.
611
 
</td>
612
 
</tr>
613
 
<tr>
614
 
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
615
 
<td> A pointer to arbitrary data that will be passed to the <em class="parameter"><code>callback</code></em>.
616
 
</td>
617
 
</tr>
618
 
<tr>
619
 
<td><p><span class="term"><em class="parameter"><code>destroy_data</code></em> :</span></p></td>
620
 
<td> A function to free <em class="parameter"><code>data</code></em> when it's no longer needed.
621
 
</td>
622
 
</tr>
623
 
<tr>
624
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
625
 
<td> The asychronous request, which can be passed to <a class="link" href="gnome-keyring-gnome-keyring-misc.html#gnome-keyring-cancel-request" title="gnome_keyring_cancel_request ()"><code class="function">gnome_keyring_cancel_request()</code></a>.
626
 
</td>
627
 
</tr>
628
 
</tbody>
629
 
</table></div>
630
 
</div>
631
 
<hr>
632
 
<div class="refsect2" title="gnome_keyring_create_sync ()">
633
 
<a name="gnome-keyring-create-sync"></a><h3>gnome_keyring_create_sync ()</h3>
634
 
<pre class="programlisting"><a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  gnome_keyring_create_sync           (const char *keyring_name,
635
 
                                                         const char *password);</pre>
636
 
<p>
637
 
Create a new keyring with the specified name. In most cases <a
638
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
639
 
><code class="literal">NULL</code></a> will be 
640
 
passed in as the <em class="parameter"><code>password</code></em>, which will prompt the user to enter a password 
641
 
of their choice.
642
 
</p>
643
 
<p>
644
 
For an asynchronous version of this function see <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-create" title="gnome_keyring_create ()"><code class="function">gnome_keyring_create()</code></a>.</p>
645
 
<p>
646
 
</p>
647
 
<div class="variablelist"><table border="0">
648
 
<col align="left" valign="top">
649
 
<tbody>
650
 
<tr>
651
 
<td><p><span class="term"><em class="parameter"><code>keyring_name</code></em> :</span></p></td>
652
 
<td> The new keyring name. Must not be <a
653
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
654
 
><code class="literal">NULL</code></a>
655
 
</td>
656
 
</tr>
657
 
<tr>
658
 
<td><p><span class="term"><em class="parameter"><code>password</code></em> :</span></p></td>
659
 
<td> The password for the new keyring. If <a
660
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
661
 
><code class="literal">NULL</code></a> user will be prompted.
662
 
</td>
663
 
</tr>
664
 
<tr>
665
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
666
 
<td> <code class="literal">GNOME_KEYRING_RESULT_OK</code> if the operation was succcessful or 
667
 
an error result otherwise.
668
 
</td>
669
 
</tr>
670
 
</tbody>
671
 
</table></div>
672
 
</div>
673
 
<hr>
674
 
<div class="refsect2" title="gnome_keyring_unlock ()">
675
 
<a name="gnome-keyring-unlock"></a><h3>gnome_keyring_unlock ()</h3>
676
 
<pre class="programlisting"><a
677
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
678
 
>gpointer</a>            gnome_keyring_unlock                (const char *keyring,
679
 
                                                         const char *password,
680
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-generic-callbacks.html#GnomeKeyringOperationDoneCallback" title="GnomeKeyringOperationDoneCallback ()">GnomeKeyringOperationDoneCallback</a> callback,
681
 
                                                         <a
682
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
683
 
>gpointer</a> data,
684
 
                                                         <a
685
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
686
 
>GDestroyNotify</a> destroy_data);</pre>
687
 
<p>
688
 
Unlock a <em class="parameter"><code>keyring</code></em>, so that its contents may be accessed. In most cases <a
689
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
690
 
><code class="literal">NULL</code></a>
691
 
will be passed as the <em class="parameter"><code>password</code></em>, which will prompt the user to enter the 
692
 
correct password.
693
 
</p>
694
 
<p>
695
 
Most keyring operations involving items require that you first unlock the 
696
 
keyring. One exception is <a class="link" href="gnome-keyring-gnome-keyring-find.html#gnome-keyring-find-items" title="gnome_keyring_find_items ()"><code class="function">gnome_keyring_find_items()</code></a> and related functions.
697
 
</p>
698
 
<p>
699
 
For a synchronous version of this function see <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-unlock-sync" title="gnome_keyring_unlock_sync ()"><code class="function">gnome_keyring_unlock_sync()</code></a>.</p>
700
 
<p>
701
 
</p>
702
 
<div class="variablelist"><table border="0">
703
 
<col align="left" valign="top">
704
 
<tbody>
705
 
<tr>
706
 
<td><p><span class="term"><em class="parameter"><code>keyring</code></em> :</span></p></td>
707
 
<td> The name of the keyring to unlock, or <a
708
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
709
 
><code class="literal">NULL</code></a> for the default keyring.
710
 
</td>
711
 
</tr>
712
 
<tr>
713
 
<td><p><span class="term"><em class="parameter"><code>password</code></em> :</span></p></td>
714
 
<td> The password to unlock the keyring with, or <a
715
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
716
 
><code class="literal">NULL</code></a> to prompt the user.
717
 
</td>
718
 
</tr>
719
 
<tr>
720
 
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
721
 
<td> A callback which will be called when the request completes or fails.
722
 
</td>
723
 
</tr>
724
 
<tr>
725
 
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
726
 
<td> A pointer to arbitrary data that will be passed to the <em class="parameter"><code>callback</code></em>.
727
 
</td>
728
 
</tr>
729
 
<tr>
730
 
<td><p><span class="term"><em class="parameter"><code>destroy_data</code></em> :</span></p></td>
731
 
<td> A function to free <em class="parameter"><code>data</code></em> when it's no longer needed.
732
 
</td>
733
 
</tr>
734
 
<tr>
735
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
736
 
<td> The asychronous request, which can be passed to <a class="link" href="gnome-keyring-gnome-keyring-misc.html#gnome-keyring-cancel-request" title="gnome_keyring_cancel_request ()"><code class="function">gnome_keyring_cancel_request()</code></a>.
737
 
</td>
738
 
</tr>
739
 
</tbody>
740
 
</table></div>
741
 
</div>
742
 
<hr>
743
 
<div class="refsect2" title="gnome_keyring_unlock_sync ()">
744
 
<a name="gnome-keyring-unlock-sync"></a><h3>gnome_keyring_unlock_sync ()</h3>
745
 
<pre class="programlisting"><a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  gnome_keyring_unlock_sync           (const char *keyring,
746
 
                                                         const char *password);</pre>
747
 
<p>
748
 
Lock a <em class="parameter"><code>keyring</code></em>, so that its contents may not be accessed without first
749
 
supplying a password. 
750
 
</p>
751
 
<p>
752
 
Most keyring opretaions involving items require that you first unlock the 
753
 
keyring. One exception is <a class="link" href="gnome-keyring-gnome-keyring-find.html#gnome-keyring-find-items-sync" title="gnome_keyring_find_items_sync ()"><code class="function">gnome_keyring_find_items_sync()</code></a> and related functions.
754
 
</p>
755
 
<p>
756
 
For an asynchronous version of this function see <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-lock" title="gnome_keyring_lock ()"><code class="function">gnome_keyring_lock()</code></a>.</p>
757
 
<p>
758
 
</p>
759
 
<div class="variablelist"><table border="0">
760
 
<col align="left" valign="top">
761
 
<tbody>
762
 
<tr>
763
 
<td><p><span class="term"><em class="parameter"><code>keyring</code></em> :</span></p></td>
764
 
<td> The name of the keyring to lock, or <a
765
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
766
 
><code class="literal">NULL</code></a> for the default keyring.
767
 
</td>
768
 
</tr>
769
 
<tr>
770
 
<td><p><span class="term"><em class="parameter"><code>password</code></em> :</span></p></td>
771
 
<td>
772
 
</td>
773
 
</tr>
774
 
<tr>
775
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
776
 
<td> <code class="literal">GNOME_KEYRING_RESULT_OK</code> if the operation was succcessful or 
777
 
an error result otherwise. 
778
 
</td>
779
 
</tr>
780
 
</tbody>
781
 
</table></div>
782
 
</div>
783
 
<hr>
784
 
<div class="refsect2" title="gnome_keyring_lock ()">
785
 
<a name="gnome-keyring-lock"></a><h3>gnome_keyring_lock ()</h3>
786
 
<pre class="programlisting"><a
787
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
788
 
>gpointer</a>            gnome_keyring_lock                  (const char *keyring,
789
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-generic-callbacks.html#GnomeKeyringOperationDoneCallback" title="GnomeKeyringOperationDoneCallback ()">GnomeKeyringOperationDoneCallback</a> callback,
790
 
                                                         <a
791
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
792
 
>gpointer</a> data,
793
 
                                                         <a
794
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
795
 
>GDestroyNotify</a> destroy_data);</pre>
796
 
<p>
797
 
Lock a <em class="parameter"><code>keyring</code></em>, so that its contents may not be accessed without first 
798
 
supplying a password. 
799
 
</p>
800
 
<p>
801
 
Most keyring operations involving items require that you first unlock the 
802
 
keyring. One exception is <a class="link" href="gnome-keyring-gnome-keyring-find.html#gnome-keyring-find-items" title="gnome_keyring_find_items ()"><code class="function">gnome_keyring_find_items()</code></a> and related functions.
803
 
</p>
804
 
<p>
805
 
For a synchronous version of this function see <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-lock-sync" title="gnome_keyring_lock_sync ()"><code class="function">gnome_keyring_lock_sync()</code></a>.</p>
806
 
<p>
807
 
</p>
808
 
<div class="variablelist"><table border="0">
809
 
<col align="left" valign="top">
810
 
<tbody>
811
 
<tr>
812
 
<td><p><span class="term"><em class="parameter"><code>keyring</code></em> :</span></p></td>
813
 
<td> The name of the keyring to lock, or <a
814
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
815
 
><code class="literal">NULL</code></a> for the default keyring.
816
 
</td>
817
 
</tr>
818
 
<tr>
819
 
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
820
 
<td> A callback which will be called when the request completes or fails.
821
 
</td>
822
 
</tr>
823
 
<tr>
824
 
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
825
 
<td> A pointer to arbitrary data that will be passed to the <em class="parameter"><code>callback</code></em>.
826
 
</td>
827
 
</tr>
828
 
<tr>
829
 
<td><p><span class="term"><em class="parameter"><code>destroy_data</code></em> :</span></p></td>
830
 
<td> A function to free <em class="parameter"><code>data</code></em> when it's no longer needed.
831
 
</td>
832
 
</tr>
833
 
<tr>
834
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
835
 
<td> The asychronous request, which can be passed to <a class="link" href="gnome-keyring-gnome-keyring-misc.html#gnome-keyring-cancel-request" title="gnome_keyring_cancel_request ()"><code class="function">gnome_keyring_cancel_request()</code></a>.
836
 
</td>
837
 
</tr>
838
 
</tbody>
839
 
</table></div>
840
 
</div>
841
 
<hr>
842
 
<div class="refsect2" title="gnome_keyring_lock_sync ()">
843
 
<a name="gnome-keyring-lock-sync"></a><h3>gnome_keyring_lock_sync ()</h3>
844
 
<pre class="programlisting"><a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  gnome_keyring_lock_sync             (const char *keyring);</pre>
845
 
<p>
846
 
</p>
847
 
<div class="variablelist"><table border="0">
848
 
<col align="left" valign="top">
849
 
<tbody>
850
 
<tr>
851
 
<td><p><span class="term"><em class="parameter"><code>keyring</code></em> :</span></p></td>
852
 
<td>
853
 
</td>
854
 
</tr>
855
 
<tr>
856
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
857
 
<td>
858
 
</td>
859
 
</tr>
860
 
</tbody>
861
 
</table></div>
862
 
</div>
863
 
<hr>
864
 
<div class="refsect2" title="gnome_keyring_delete ()">
865
 
<a name="gnome-keyring-delete"></a><h3>gnome_keyring_delete ()</h3>
866
 
<pre class="programlisting"><a
867
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
868
 
>gpointer</a>            gnome_keyring_delete                (const char *keyring,
869
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-generic-callbacks.html#GnomeKeyringOperationDoneCallback" title="GnomeKeyringOperationDoneCallback ()">GnomeKeyringOperationDoneCallback</a> callback,
870
 
                                                         <a
871
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
872
 
>gpointer</a> data,
873
 
                                                         <a
874
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
875
 
>GDestroyNotify</a> destroy_data);</pre>
876
 
<p>
877
 
Delete <em class="parameter"><code>keyring</code></em>. Once a keyring is deleted there is no mechanism for 
878
 
recovery of its contents. 
879
 
</p>
880
 
<p>
881
 
For a synchronous version of this function see <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-delete-sync" title="gnome_keyring_delete_sync ()"><code class="function">gnome_keyring_delete_sync()</code></a>.</p>
882
 
<p>
883
 
</p>
884
 
<div class="variablelist"><table border="0">
885
 
<col align="left" valign="top">
886
 
<tbody>
887
 
<tr>
888
 
<td><p><span class="term"><em class="parameter"><code>keyring</code></em> :</span></p></td>
889
 
<td> The name of the keyring to delete. Cannot be <a
890
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
891
 
><code class="literal">NULL</code></a>.
892
 
</td>
893
 
</tr>
894
 
<tr>
895
 
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
896
 
<td> A callback which will be called when the request completes or fails.
897
 
</td>
898
 
</tr>
899
 
<tr>
900
 
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
901
 
<td> A pointer to arbitrary data that will be passed to the <em class="parameter"><code>callback</code></em>.
902
 
</td>
903
 
</tr>
904
 
<tr>
905
 
<td><p><span class="term"><em class="parameter"><code>destroy_data</code></em> :</span></p></td>
906
 
<td> A function to free <em class="parameter"><code>data</code></em> when it's no longer needed.
907
 
</td>
908
 
</tr>
909
 
<tr>
910
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
911
 
<td> The asychronous request, which can be passed to <a class="link" href="gnome-keyring-gnome-keyring-misc.html#gnome-keyring-cancel-request" title="gnome_keyring_cancel_request ()"><code class="function">gnome_keyring_cancel_request()</code></a>.
912
 
</td>
913
 
</tr>
914
 
</tbody>
915
 
</table></div>
916
 
</div>
917
 
<hr>
918
 
<div class="refsect2" title="gnome_keyring_delete_sync ()">
919
 
<a name="gnome-keyring-delete-sync"></a><h3>gnome_keyring_delete_sync ()</h3>
920
 
<pre class="programlisting"><a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  gnome_keyring_delete_sync           (const char *keyring);</pre>
921
 
<p>
922
 
Delete <em class="parameter"><code>keyring</code></em>. Once a keyring is deleted there is no mechanism for 
923
 
recovery of its contents. 
924
 
</p>
925
 
<p>
926
 
For an asynchronous version of this function see <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-delete" title="gnome_keyring_delete ()"><code class="function">gnome_keyring_delete()</code></a>.</p>
927
 
<p>
928
 
</p>
929
 
<div class="variablelist"><table border="0">
930
 
<col align="left" valign="top">
931
 
<tbody>
932
 
<tr>
933
 
<td><p><span class="term"><em class="parameter"><code>keyring</code></em> :</span></p></td>
934
 
<td> The name of the keyring to delete. Cannot be <a
935
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
936
 
><code class="literal">NULL</code></a>
937
 
</td>
938
 
</tr>
939
 
<tr>
940
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
941
 
<td> <code class="literal">GNOME_KEYRING_RESULT_OK</code> if the operation was succcessful or 
942
 
an error result otherwise. 
943
 
</td>
944
 
</tr>
945
 
</tbody>
946
 
</table></div>
947
 
</div>
948
 
<hr>
949
 
<div class="refsect2" title="gnome_keyring_get_info ()">
950
 
<a name="gnome-keyring-get-info"></a><h3>gnome_keyring_get_info ()</h3>
951
 
<pre class="programlisting"><a
952
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
953
 
>gpointer</a>            gnome_keyring_get_info              (const char *keyring,
954
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#GnomeKeyringOperationGetKeyringInfoCallback" title="GnomeKeyringOperationGetKeyringInfoCallback ()">GnomeKeyringOperationGetKeyringInfoCallback</a> callback,
955
 
                                                         <a
956
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
957
 
>gpointer</a> data,
958
 
                                                         <a
959
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
960
 
>GDestroyNotify</a> destroy_data);</pre>
961
 
<p>
962
 
Get information about the <em class="parameter"><code>keyring</code></em>. The resulting <a class="link" href="gnome-keyring-gnome-keyring-keyring-info.html#GnomeKeyringInfo" title="GnomeKeyringInfo"><span class="type">GnomeKeyringInfo</span></a> structure 
963
 
will be passed to <em class="parameter"><code>callback</code></em>. The structure is freed after <em class="parameter"><code>callback</code></em> returns.
964
 
</p>
965
 
<p>
966
 
For a synchronous version of this function see <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-get-info-sync" title="gnome_keyring_get_info_sync ()"><code class="function">gnome_keyring_get_info_sync()</code></a>.</p>
967
 
<p>
968
 
</p>
969
 
<div class="variablelist"><table border="0">
970
 
<col align="left" valign="top">
971
 
<tbody>
972
 
<tr>
973
 
<td><p><span class="term"><em class="parameter"><code>keyring</code></em> :</span></p></td>
974
 
<td> The name of the keyring, or <a
975
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
976
 
><code class="literal">NULL</code></a> for the default keyring.
977
 
</td>
978
 
</tr>
979
 
<tr>
980
 
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
981
 
<td> A callback which will be called when the request completes or fails.
982
 
</td>
983
 
</tr>
984
 
<tr>
985
 
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
986
 
<td> A pointer to arbitrary data that will be passed to the <em class="parameter"><code>callback</code></em>.
987
 
</td>
988
 
</tr>
989
 
<tr>
990
 
<td><p><span class="term"><em class="parameter"><code>destroy_data</code></em> :</span></p></td>
991
 
<td> A function to free <em class="parameter"><code>data</code></em> when it's no longer needed.
992
 
</td>
993
 
</tr>
994
 
<tr>
995
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
996
 
<td> The asychronous request, which can be passed to <a class="link" href="gnome-keyring-gnome-keyring-misc.html#gnome-keyring-cancel-request" title="gnome_keyring_cancel_request ()"><code class="function">gnome_keyring_cancel_request()</code></a>.
997
 
</td>
998
 
</tr>
999
 
</tbody>
1000
 
</table></div>
1001
 
</div>
1002
 
<hr>
1003
 
<div class="refsect2" title="gnome_keyring_get_info_sync ()">
1004
 
<a name="gnome-keyring-get-info-sync"></a><h3>gnome_keyring_get_info_sync ()</h3>
1005
 
<pre class="programlisting"><a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  gnome_keyring_get_info_sync         (const char *keyring,
1006
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-keyring-info.html#GnomeKeyringInfo" title="GnomeKeyringInfo">GnomeKeyringInfo</a> **info);</pre>
1007
 
<p>
1008
 
Get information about <em class="parameter"><code>keyring</code></em>. 
1009
 
</p>
1010
 
<p>
1011
 
The <a class="link" href="gnome-keyring-gnome-keyring-keyring-info.html#GnomeKeyringInfo" title="GnomeKeyringInfo"><span class="type">GnomeKeyringInfo</span></a> structure returned in <em class="parameter"><code>info</code></em> must be freed with 
1012
 
<a class="link" href="gnome-keyring-gnome-keyring-keyring-info.html#gnome-keyring-info-free" title="gnome_keyring_info_free ()"><code class="function">gnome_keyring_info_free()</code></a>.
1013
 
</p>
1014
 
<p>
1015
 
For an asynchronous version of this function see <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-get-info" title="gnome_keyring_get_info ()"><code class="function">gnome_keyring_get_info()</code></a>.</p>
1016
 
<p>
1017
 
</p>
1018
 
<div class="variablelist"><table border="0">
1019
 
<col align="left" valign="top">
1020
 
<tbody>
1021
 
<tr>
1022
 
<td><p><span class="term"><em class="parameter"><code>keyring</code></em> :</span></p></td>
1023
 
<td> The name of the keyring, or <a
1024
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1025
 
><code class="literal">NULL</code></a> for the default keyring.
1026
 
</td>
1027
 
</tr>
1028
 
<tr>
1029
 
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
1030
 
<td> Location for the information about the keyring to be returned.
1031
 
</td>
1032
 
</tr>
1033
 
<tr>
1034
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1035
 
<td> <code class="literal">GNOME_KEYRING_RESULT_OK</code> if the operation was succcessful or 
1036
 
an error result otherwise. 
1037
 
</td>
1038
 
</tr>
1039
 
</tbody>
1040
 
</table></div>
1041
 
</div>
1042
 
<hr>
1043
 
<div class="refsect2" title="gnome_keyring_set_info ()">
1044
 
<a name="gnome-keyring-set-info"></a><h3>gnome_keyring_set_info ()</h3>
1045
 
<pre class="programlisting"><a
1046
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1047
 
>gpointer</a>            gnome_keyring_set_info              (const char *keyring,
1048
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-keyring-info.html#GnomeKeyringInfo" title="GnomeKeyringInfo">GnomeKeyringInfo</a> *info,
1049
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-generic-callbacks.html#GnomeKeyringOperationDoneCallback" title="GnomeKeyringOperationDoneCallback ()">GnomeKeyringOperationDoneCallback</a> callback,
1050
 
                                                         <a
1051
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1052
 
>gpointer</a> data,
1053
 
                                                         <a
1054
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
1055
 
>GDestroyNotify</a> destroy_data);</pre>
1056
 
<p>
1057
 
Set flags and info for the <em class="parameter"><code>keyring</code></em>. The only fields in <em class="parameter"><code>info</code></em> that are used 
1058
 
are <code class="literal">lock_on_idle</code> and <code class="literal">lock_timeout</code>. 
1059
 
</p>
1060
 
<p>
1061
 
For a synchronous version of this function see <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-set-info-sync" title="gnome_keyring_set_info_sync ()"><code class="function">gnome_keyring_set_info_sync()</code></a>.</p>
1062
 
<p>
1063
 
</p>
1064
 
<div class="variablelist"><table border="0">
1065
 
<col align="left" valign="top">
1066
 
<tbody>
1067
 
<tr>
1068
 
<td><p><span class="term"><em class="parameter"><code>keyring</code></em> :</span></p></td>
1069
 
<td> The name of the keyring, or <a
1070
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1071
 
><code class="literal">NULL</code></a> for the default keyring.
1072
 
</td>
1073
 
</tr>
1074
 
<tr>
1075
 
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
1076
 
<td> A structure containing flags and info for the keyring.
1077
 
</td>
1078
 
</tr>
1079
 
<tr>
1080
 
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1081
 
<td> A callback which will be called when the request completes or fails.
1082
 
</td>
1083
 
</tr>
1084
 
<tr>
1085
 
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1086
 
<td> A pointer to arbitrary data that will be passed to the <em class="parameter"><code>callback</code></em>.
1087
 
</td>
1088
 
</tr>
1089
 
<tr>
1090
 
<td><p><span class="term"><em class="parameter"><code>destroy_data</code></em> :</span></p></td>
1091
 
<td> A function to free <em class="parameter"><code>data</code></em> when it's no longer needed.
1092
 
</td>
1093
 
</tr>
1094
 
<tr>
1095
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1096
 
<td> The asychronous request, which can be passed to <a class="link" href="gnome-keyring-gnome-keyring-misc.html#gnome-keyring-cancel-request" title="gnome_keyring_cancel_request ()"><code class="function">gnome_keyring_cancel_request()</code></a>.
1097
 
</td>
1098
 
</tr>
1099
 
</tbody>
1100
 
</table></div>
1101
 
</div>
1102
 
<hr>
1103
 
<div class="refsect2" title="gnome_keyring_set_info_sync ()">
1104
 
<a name="gnome-keyring-set-info-sync"></a><h3>gnome_keyring_set_info_sync ()</h3>
1105
 
<pre class="programlisting"><a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  gnome_keyring_set_info_sync         (const char *keyring,
1106
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-keyring-info.html#GnomeKeyringInfo" title="GnomeKeyringInfo">GnomeKeyringInfo</a> *info);</pre>
1107
 
<p>
1108
 
Set flags and info for <em class="parameter"><code>keyring</code></em>. The only fields in <em class="parameter"><code>info</code></em> that are used
1109
 
are <code class="literal">lock_on_idle</code> and <code class="literal">lock_timeout</code>.
1110
 
</p>
1111
 
<p>
1112
 
For an asynchronous version of this function see <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-set-info" title="gnome_keyring_set_info ()"><code class="function">gnome_keyring_set_info()</code></a>.</p>
1113
 
<p>
1114
 
</p>
1115
 
<div class="variablelist"><table border="0">
1116
 
<col align="left" valign="top">
1117
 
<tbody>
1118
 
<tr>
1119
 
<td><p><span class="term"><em class="parameter"><code>keyring</code></em> :</span></p></td>
1120
 
<td> The name of the keyring, or <a
1121
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1122
 
><code class="literal">NULL</code></a> for the default keyring.
1123
 
</td>
1124
 
</tr>
1125
 
<tr>
1126
 
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
1127
 
<td> A structure containing flags and info for the keyring.
1128
 
</td>
1129
 
</tr>
1130
 
<tr>
1131
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1132
 
<td> <code class="literal">GNOME_KEYRING_RESULT_OK</code> if the operation was succcessful or 
1133
 
an error result otherwise. 
1134
 
</td>
1135
 
</tr>
1136
 
</tbody>
1137
 
</table></div>
1138
 
</div>
1139
 
<hr>
1140
 
<div class="refsect2" title="gnome_keyring_change_password ()">
1141
 
<a name="gnome-keyring-change-password"></a><h3>gnome_keyring_change_password ()</h3>
1142
 
<pre class="programlisting"><a
1143
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1144
 
>gpointer</a>            gnome_keyring_change_password       (const char *keyring,
1145
 
                                                         const char *original,
1146
 
                                                         const char *password,
1147
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-generic-callbacks.html#GnomeKeyringOperationDoneCallback" title="GnomeKeyringOperationDoneCallback ()">GnomeKeyringOperationDoneCallback</a> callback,
1148
 
                                                         <a
1149
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1150
 
>gpointer</a> data,
1151
 
                                                         <a
1152
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
1153
 
>GDestroyNotify</a> destroy_data);</pre>
1154
 
<p>
1155
 
Change the password for a <em class="parameter"><code>keyring</code></em>. In most cases you would specify <a
1156
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1157
 
><code class="literal">NULL</code></a> for
1158
 
both the <em class="parameter"><code>original</code></em> and <em class="parameter"><code>password</code></em> arguments and allow the user to type the 
1159
 
correct passwords. 
1160
 
</p>
1161
 
<p>
1162
 
For a synchronous version of this function see <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-change-password-sync" title="gnome_keyring_change_password_sync ()"><code class="function">gnome_keyring_change_password_sync()</code></a>.</p>
1163
 
<p>
1164
 
</p>
1165
 
<div class="variablelist"><table border="0">
1166
 
<col align="left" valign="top">
1167
 
<tbody>
1168
 
<tr>
1169
 
<td><p><span class="term"><em class="parameter"><code>keyring</code></em> :</span></p></td>
1170
 
<td> The name of the keyring to change the password for. Cannot be <a
1171
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1172
 
><code class="literal">NULL</code></a>.
1173
 
</td>
1174
 
</tr>
1175
 
<tr>
1176
 
<td><p><span class="term"><em class="parameter"><code>original</code></em> :</span></p></td>
1177
 
<td> The old keyring password, or <a
1178
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1179
 
><code class="literal">NULL</code></a> to prompt the user for it.
1180
 
</td>
1181
 
</tr>
1182
 
<tr>
1183
 
<td><p><span class="term"><em class="parameter"><code>password</code></em> :</span></p></td>
1184
 
<td> The new keyring password, or <a
1185
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1186
 
><code class="literal">NULL</code></a> to prompt the user for it. 
1187
 
</td>
1188
 
</tr>
1189
 
<tr>
1190
 
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1191
 
<td> A callback which will be called when the request completes or fails.
1192
 
</td>
1193
 
</tr>
1194
 
<tr>
1195
 
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1196
 
<td> A pointer to arbitrary data that will be passed to the <em class="parameter"><code>callback</code></em>.
1197
 
</td>
1198
 
</tr>
1199
 
<tr>
1200
 
<td><p><span class="term"><em class="parameter"><code>destroy_data</code></em> :</span></p></td>
1201
 
<td> A function to free <em class="parameter"><code>data</code></em> when it's no longer needed.
1202
 
</td>
1203
 
</tr>
1204
 
<tr>
1205
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1206
 
<td> The asychronous request, which can be passed to <a class="link" href="gnome-keyring-gnome-keyring-misc.html#gnome-keyring-cancel-request" title="gnome_keyring_cancel_request ()"><code class="function">gnome_keyring_cancel_request()</code></a>.
1207
 
</td>
1208
 
</tr>
1209
 
</tbody>
1210
 
</table></div>
1211
 
</div>
1212
 
<hr>
1213
 
<div class="refsect2" title="gnome_keyring_change_password_sync ()">
1214
 
<a name="gnome-keyring-change-password-sync"></a><h3>gnome_keyring_change_password_sync ()</h3>
1215
 
<pre class="programlisting"><a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  gnome_keyring_change_password_sync  (const char *keyring,
1216
 
                                                         const char *original,
1217
 
                                                         const char *password);</pre>
1218
 
<p>
1219
 
Change the password for <em class="parameter"><code>keyring</code></em>. In most cases you would specify <a
1220
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1221
 
><code class="literal">NULL</code></a> for
1222
 
both the <em class="parameter"><code>original</code></em> and <em class="parameter"><code>password</code></em> arguments and allow the user to type the 
1223
 
correct passwords.  
1224
 
</p>
1225
 
<p>
1226
 
For an asynchronous version of this function see <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-change-password" title="gnome_keyring_change_password ()"><code class="function">gnome_keyring_change_password()</code></a>.</p>
1227
 
<p>
1228
 
</p>
1229
 
<div class="variablelist"><table border="0">
1230
 
<col align="left" valign="top">
1231
 
<tbody>
1232
 
<tr>
1233
 
<td><p><span class="term"><em class="parameter"><code>keyring</code></em> :</span></p></td>
1234
 
<td> The name of the keyring to change the password for. Cannot be <a
1235
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1236
 
><code class="literal">NULL</code></a>
1237
 
</td>
1238
 
</tr>
1239
 
<tr>
1240
 
<td><p><span class="term"><em class="parameter"><code>original</code></em> :</span></p></td>
1241
 
<td> The old keyring password, or <a
1242
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1243
 
><code class="literal">NULL</code></a> to prompt the user for it.
1244
 
</td>
1245
 
</tr>
1246
 
<tr>
1247
 
<td><p><span class="term"><em class="parameter"><code>password</code></em> :</span></p></td>
1248
 
<td> The new keyring password, or <a
1249
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1250
 
><code class="literal">NULL</code></a> to prompt the user for it.
1251
 
</td>
1252
 
</tr>
1253
 
<tr>
1254
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1255
 
<td> <code class="literal">GNOME_KEYRING_RESULT_OK</code> if the operation was succcessful or 
1256
 
an error result otherwise. 
1257
 
</td>
1258
 
</tr>
1259
 
</tbody>
1260
 
</table></div>
1261
 
</div>
1262
 
<hr>
1263
 
<div class="refsect2" title="gnome_keyring_list_item_ids ()">
1264
 
<a name="gnome-keyring-list-item-ids"></a><h3>gnome_keyring_list_item_ids ()</h3>
1265
 
<pre class="programlisting"><a
1266
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1267
 
>gpointer</a>            gnome_keyring_list_item_ids         (const char *keyring,
1268
 
                                                         <a class="link" href="gnome-keyring-gnome-keyring-generic-callbacks.html#GnomeKeyringOperationGetListCallback" title="GnomeKeyringOperationGetListCallback ()">GnomeKeyringOperationGetListCallback</a> callback,
1269
 
                                                         <a
1270
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1271
 
>gpointer</a> data,
1272
 
                                                         <a
1273
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
1274
 
>GDestroyNotify</a> destroy_data);</pre>
1275
 
<p>
1276
 
Get a list of all the ids for items in <em class="parameter"><code>keyring</code></em>. These are passed in a <a
1277
 
href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"
1278
 
><code class="literal">GList</code></a>
1279
 
to the <em class="parameter"><code>callback</code></em>. Use <a
1280
 
href="http://library.gnome.org/devel/glib/unstable/glib-Type-Conversion-Macros.html#GPOINTER-TO-UINT--CAPS"
1281
 
><code class="function">GPOINTER_TO_UINT()</code></a> on the list to access the integer ids.
1282
 
The list is freed after <em class="parameter"><code>callback</code></em> returns.
1283
 
</p>
1284
 
<p>
1285
 
All items that are not flagged as <code class="literal">GNOME_KEYRING_ITEM_APPLICATION_SECRET</code> are 
1286
 
included in the list. This includes items that the calling application may not 
1287
 
(yet) have access to.
1288
 
</p>
1289
 
<p>
1290
 
For a synchronous version of this function see <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-list-item-ids-sync" title="gnome_keyring_list_item_ids_sync ()"><code class="function">gnome_keyring_list_item_ids_sync()</code></a>.</p>
1291
 
<p>
1292
 
</p>
1293
 
<div class="variablelist"><table border="0">
1294
 
<col align="left" valign="top">
1295
 
<tbody>
1296
 
<tr>
1297
 
<td><p><span class="term"><em class="parameter"><code>keyring</code></em> :</span></p></td>
1298
 
<td> The name of the keyring, or <a
1299
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1300
 
><code class="literal">NULL</code></a> for the default keyring.
1301
 
</td>
1302
 
</tr>
1303
 
<tr>
1304
 
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1305
 
<td> A callback which will be called when the request completes or fails.
1306
 
</td>
1307
 
</tr>
1308
 
<tr>
1309
 
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1310
 
<td> A pointer to arbitrary data that will be passed to the <em class="parameter"><code>callback</code></em>.
1311
 
</td>
1312
 
</tr>
1313
 
<tr>
1314
 
<td><p><span class="term"><em class="parameter"><code>destroy_data</code></em> :</span></p></td>
1315
 
<td> A function to free <em class="parameter"><code>data</code></em> when it's no longer needed.
1316
 
</td>
1317
 
</tr>
1318
 
<tr>
1319
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1320
 
<td> The asychronous request, which can be passed to <a class="link" href="gnome-keyring-gnome-keyring-misc.html#gnome-keyring-cancel-request" title="gnome_keyring_cancel_request ()"><code class="function">gnome_keyring_cancel_request()</code></a>.
1321
 
</td>
1322
 
</tr>
1323
 
</tbody>
1324
 
</table></div>
1325
 
</div>
1326
 
<hr>
1327
 
<div class="refsect2" title="gnome_keyring_list_item_ids_sync ()">
1328
 
<a name="gnome-keyring-list-item-ids-sync"></a><h3>gnome_keyring_list_item_ids_sync ()</h3>
1329
 
<pre class="programlisting"><a class="link" href="gnome-keyring-gnome-keyring-result.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a>  gnome_keyring_list_item_ids_sync    (const char *keyring,
1330
 
                                                         <a
1331
 
href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"
1332
 
>GList</a> **ids);</pre>
1333
 
<p>
1334
 
Get a list of all the ids for items in <em class="parameter"><code>keyring</code></em>. 
1335
 
</p>
1336
 
<p>
1337
 
Use <a
1338
 
href="http://library.gnome.org/devel/glib/unstable/glib-Type-Conversion-Macros.html#GPOINTER-TO-UINT--CAPS"
1339
 
><code class="function">GPOINTER_TO_UINT()</code></a> on the list to access the integer ids. The list 
1340
 
should be freed with <a
1341
 
href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"
1342
 
><code class="function">g_list_free()</code></a>. 
1343
 
</p>
1344
 
<p>
1345
 
For an asynchronous version of this function see <a class="link" href="gnome-keyring-gnome-keyring-keyrings.html#gnome-keyring-list-item-ids" title="gnome_keyring_list_item_ids ()"><code class="function">gnome_keyring_list_item_ids()</code></a>.</p>
1346
 
<p>
1347
 
</p>
1348
 
<div class="variablelist"><table border="0">
1349
 
<col align="left" valign="top">
1350
 
<tbody>
1351
 
<tr>
1352
 
<td><p><span class="term"><em class="parameter"><code>keyring</code></em> :</span></p></td>
1353
 
<td> The name of the keyring, or <a
1354
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1355
 
><code class="literal">NULL</code></a> for the default keyring.
1356
 
</td>
1357
 
</tr>
1358
 
<tr>
1359
 
<td><p><span class="term"><em class="parameter"><code>ids</code></em> :</span></p></td>
1360
 
<td> The location to store a <a
1361
 
href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"
1362
 
><code class="literal">GList</code></a> of item ids (ie: unsigned integers).
1363
 
</td>
1364
 
</tr>
1365
 
<tr>
1366
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1367
 
<td> <code class="literal">GNOME_KEYRING_RESULT_OK</code> if the operation was succcessful or 
1368
 
an error result otherwise. 
1369
 
</td>
1370
 
</tr>
1371
 
</tbody>
1372
 
</table></div>
1373
 
</div>
1374
 
</div>
1375
 
</div>
1376
 
<div class="footer">
1377
 
<hr>
1378
 
          Generated by GTK-Doc V1.11</div>
1379
 
</body>
1380
 
</html>