~ubuntu-branches/ubuntu/quantal/libgnome-keyring/quantal

<pre class="synopsis">void (<a class="link" href="gnome-keyring-Keyrings.html#GnomeKeyringOperationGetKeyringInfoCallback" title="GnomeKeyringOperationGetKeyringInfoCallback ()">*GnomeKeyringOperationGetKeyringInfoCallback</a>)

(<code><a class="link" href="gnome-keyring-Result-Codes.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a> result</code>,

<code><a class="link" href="gnome-keyring-Keyring-Info.html#GnomeKeyringInfo" title="GnomeKeyringInfo">GnomeKeyringInfo</a> *info</code>,

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);

<code><a class="link" href="gnome-keyring-Callbacks.html#GnomeKeyringOperationDoneCallback" title="GnomeKeyringOperationDoneCallback ()">GnomeKeyringOperationDoneCallback</a> callback</code>,

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

<a class="link" href="gnome-keyring-Result-Codes.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-set-default-keyring-sync" title="gnome_keyring_set_default_keyring_sync ()">gnome_keyring_set_default_keyring_sync</a>

(<code>const char *keyring</code>);

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-get-default-keyring" title="gnome_keyring_get_default_keyring ()">gnome_keyring_get_default_keyring</a> (<code><a class="link" href="gnome-keyring-Callbacks.html#GnomeKeyringOperationGetStringCallback" title="GnomeKeyringOperationGetStringCallback ()">GnomeKeyringOperationGetStringCallback</a> callback</code>,

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-get-default-keyring" title="gnome_keyring_get_default_keyring ()">gnome_keyring_get_default_keyring</a> (<code><a class="link" href="gnome-keyring-Callbacks.html#GnomeKeyringOperationGetStringCallback" title="GnomeKeyringOperationGetStringCallback ()">GnomeKeyringOperationGetStringCallback</a> callback</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

<a class="link" href="gnome-keyring-Result-Codes.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-get-default-keyring-sync" title="gnome_keyring_get_default_keyring_sync ()">gnome_keyring_get_default_keyring_sync</a>

(<code>char **keyring</code>);

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-list-keyring-names" title="gnome_keyring_list_keyring_names ()">gnome_keyring_list_keyring_names</a> (<code><a class="link" href="gnome-keyring-Callbacks.html#GnomeKeyringOperationGetListCallback" title="GnomeKeyringOperationGetListCallback ()">GnomeKeyringOperationGetListCallback</a> callback</code>,

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-list-keyring-names" title="gnome_keyring_list_keyring_names ()">gnome_keyring_list_keyring_names</a> (<code><a class="link" href="gnome-keyring-Callbacks.html#GnomeKeyringOperationGetListCallback" title="GnomeKeyringOperationGetListCallback ()">GnomeKeyringOperationGetListCallback</a> callback</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

<a class="link" href="gnome-keyring-Result-Codes.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-list-keyring-names-sync" title="gnome_keyring_list_keyring_names_sync ()">gnome_keyring_list_keyring_names_sync</a>

(<code><a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> **keyrings</code>);

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-lock-all" title="gnome_keyring_lock_all ()">gnome_keyring_lock_all</a> (<code><a class="link" href="gnome-keyring-Callbacks.html#GnomeKeyringOperationDoneCallback" title="GnomeKeyringOperationDoneCallback ()">GnomeKeyringOperationDoneCallback</a> callback</code>,

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

(<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> **keyrings</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-lock-all" title="gnome_keyring_lock_all ()">gnome_keyring_lock_all</a> (<code><a class="link" href="gnome-keyring-Callbacks.html#GnomeKeyringOperationDoneCallback" title="GnomeKeyringOperationDoneCallback ()">GnomeKeyringOperationDoneCallback</a> callback</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

<a class="link" href="gnome-keyring-Result-Codes.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-lock-all-sync" title="gnome_keyring_lock_all_sync ()">gnome_keyring_lock_all_sync</a> (<code>void</code>);

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-create" title="gnome_keyring_create ()">gnome_keyring_create</a> (<code>const char *keyring_name</code>,

<code>const char *password</code>,

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

<a class="link" href="gnome-keyring-Result-Codes.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-create-sync" title="gnome_keyring_create_sync ()">gnome_keyring_create_sync</a> (<code>const char *keyring_name</code>,

<code>const char *password</code>);

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-unlock" title="gnome_keyring_unlock ()">gnome_keyring_unlock</a> (<code>const char *keyring</code>,

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-unlock" title="gnome_keyring_unlock ()">gnome_keyring_unlock</a> (<code>const char *keyring</code>,

<code>const char *password</code>,

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

<a class="link" href="gnome-keyring-Result-Codes.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-unlock-sync" title="gnome_keyring_unlock_sync ()">gnome_keyring_unlock_sync</a> (<code>const char *keyring</code>,

<code>const char *password</code>);

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-lock" title="gnome_keyring_lock ()">gnome_keyring_lock</a> (<code>const char *keyring</code>,

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-lock" title="gnome_keyring_lock ()">gnome_keyring_lock</a> (<code>const char *keyring</code>,

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

<a class="link" href="gnome-keyring-Result-Codes.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-lock-sync" title="gnome_keyring_lock_sync ()">gnome_keyring_lock_sync</a> (<code>const char *keyring</code>);

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-delete" title="gnome_keyring_delete ()">gnome_keyring_delete</a> (<code>const char *keyring</code>,

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

<a class="link" href="gnome-keyring-Result-Codes.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-delete-sync" title="gnome_keyring_delete_sync ()">gnome_keyring_delete_sync</a> (<code>const char *keyring</code>);

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-get-info" title="gnome_keyring_get_info ()">gnome_keyring_get_info</a> (<code>const char *keyring</code>,

<code><a class="link" href="gnome-keyring-Keyrings.html#GnomeKeyringOperationGetKeyringInfoCallback" title="GnomeKeyringOperationGetKeyringInfoCallback ()">GnomeKeyringOperationGetKeyringInfoCallback</a> callback</code>,

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

<a class="link" href="gnome-keyring-Result-Codes.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-get-info-sync" title="gnome_keyring_get_info_sync ()">gnome_keyring_get_info_sync</a> (<code>const char *keyring</code>,

<code><a class="link" href="gnome-keyring-Keyring-Info.html#GnomeKeyringInfo" title="GnomeKeyringInfo">GnomeKeyringInfo</a> **info</code>);

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-set-info" title="gnome_keyring_set_info ()">gnome_keyring_set_info</a> (<code>const char *keyring</code>,

<code><a class="link" href="gnome-keyring-Keyring-Info.html#GnomeKeyringInfo" title="GnomeKeyringInfo">GnomeKeyringInfo</a> *info</code>,

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

<a class="link" href="gnome-keyring-Result-Codes.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-set-info-sync" title="gnome_keyring_set_info_sync ()">gnome_keyring_set_info_sync</a> (<code>const char *keyring</code>,

100

<code><a class="link" href="gnome-keyring-Keyring-Info.html#GnomeKeyringInfo" title="GnomeKeyringInfo">GnomeKeyringInfo</a> *info</code>);

101

102

<code>const char *original</code>,

103

<code>const char *password</code>,

104

105

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

106

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

105

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

106

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

107

<a class="link" href="gnome-keyring-Result-Codes.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-change-password-sync" title="gnome_keyring_change_password_sync ()">gnome_keyring_change_password_sync</a> (<code>const char *keyring</code>,

108

<code>const char *original</code>,

109

<code>const char *password</code>);

110

111

<code><a class="link" href="gnome-keyring-Callbacks.html#GnomeKeyringOperationGetListCallback" title="GnomeKeyringOperationGetListCallback ()">GnomeKeyringOperationGetListCallback</a> callback</code>,

112

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

113

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

112

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

113

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);

114

<a class="link" href="gnome-keyring-Result-Codes.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a> <a class="link" href="gnome-keyring-Keyrings.html#gnome-keyring-list-item-ids-sync" title="gnome_keyring_list_item_ids_sync ()">gnome_keyring_list_item_ids_sync</a> (<code>const char *keyring</code>,

115

<code><a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> **ids</code>);

115

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> **ids</code>);

116

</pre>

117

</div>

118

123

124

125

One of the keyrings is the default keyring, which can in many cases be used

126

by specifying <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for a keyring name.

126

by specifying <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for a keyring name.

127

128

129

Each keyring can be in a locked or unlocked state. A password must be

138

<pre class="programlisting">void (*GnomeKeyringOperationGetKeyringInfoCallback)

139

140

<code><a class="link" href="gnome-keyring-Keyring-Info.html#GnomeKeyringInfo" title="GnomeKeyringInfo">GnomeKeyringInfo</a> *info</code>,

141

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);</pre>

141

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);</pre>

142

143

144

</div>

145

<hr>

146

147

<a name="gnome-keyring-set-default-keyring"></a><h3>gnome_keyring_set_default_keyring ()</h3>

148

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> gnome_keyring_set_default_keyring (<code>const char *keyring</code>,

148

149

150

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

151

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

150

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

151

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

152

153

Change the default keyring.

154

215

<hr>

216

217

<a name="gnome-keyring-get-default-keyring"></a><h3>gnome_keyring_get_default_keyring ()</h3>

218

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> gnome_keyring_get_default_keyring (<code><a class="link" href="gnome-keyring-Callbacks.html#GnomeKeyringOperationGetStringCallback" title="GnomeKeyringOperationGetStringCallback ()">GnomeKeyringOperationGetStringCallback</a> callback</code>,

219

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

220

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

218

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> gnome_keyring_get_default_keyring (<code><a class="link" href="gnome-keyring-Callbacks.html#GnomeKeyringOperationGetStringCallback" title="GnomeKeyringOperationGetStringCallback ()">GnomeKeyringOperationGetStringCallback</a> callback</code>,

219

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

220

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

221

222

Get the default keyring name, which will be passed to the <code>callback</code>. If no

223

default keyring exists, then <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be passed to the <code>callback</code>. The

223

default keyring exists, then <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be passed to the <code>callback</code>. The

224

string will be freed after <code>callback</code> returns.

225

226

261

Get the default keyring name.

262

263

264

The string returned in <code>keyring</code> must be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.

264

The string returned in <code>keyring</code> must be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.

265

266

267

For an asynchronous version of this function see <a class="link" href="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>.

286

<hr>

287

288

<a name="gnome-keyring-list-keyring-names"></a><h3>gnome_keyring_list_keyring_names ()</h3>

289

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> gnome_keyring_list_keyring_names (<code><a class="link" href="gnome-keyring-Callbacks.html#GnomeKeyringOperationGetListCallback" title="GnomeKeyringOperationGetListCallback ()">GnomeKeyringOperationGetListCallback</a> callback</code>,

290

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

291

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

289

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> gnome_keyring_list_keyring_names (<code><a class="link" href="gnome-keyring-Callbacks.html#GnomeKeyringOperationGetListCallback" title="GnomeKeyringOperationGetListCallback ()">GnomeKeyringOperationGetListCallback</a> callback</code>,

290

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

291

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

292

293

Get a list of keyring names.

294

295

296

A <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><code class="literal">GList</code></a> of null terminated strings will be passed to

296

A <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><code class="literal">GList</code></a> of null terminated strings will be passed to

297

the <code>callback</code>. If no keyrings exist then an empty list will be passed to the

298

<code>callback</code>. The list is freed after <code>callback</code> returns.

299

330

331

<a name="gnome-keyring-list-keyring-names-sync"></a><h3>gnome_keyring_list_keyring_names_sync ()</h3>

332

<pre class="programlisting"><a class="link" href="gnome-keyring-Result-Codes.html#GnomeKeyringResult" title="enum GnomeKeyringResult">GnomeKeyringResult</a> gnome_keyring_list_keyring_names_sync

333

(<code><a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> **keyrings</code>);</pre>

333

(<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> **keyrings</code>);</pre>

334

335

Get a list of keyring names.

336

346

<tbody>

347

<tr>

348

<td><code>keyrings</code> :</td>

349

<td>Location for a <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><code class="literal">GList</code></a> of keyring names to be returned. [<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>][<acronym title="Generics and defining elements of containers and arrays.">element-type</acronym> utf8]

349

<td>Location for a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><code class="literal">GList</code></a> of keyring names to be returned. [<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>][<acronym title="Generics and defining elements of containers and arrays.">element-type</acronym> utf8]

350

</td>

351

</tr>

352

<tr>

361

<hr>

362

363

<a name="gnome-keyring-lock-all"></a><h3>gnome_keyring_lock_all ()</h3>

364

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> gnome_keyring_lock_all (<code><a class="link" href="gnome-keyring-Callbacks.html#GnomeKeyringOperationDoneCallback" title="GnomeKeyringOperationDoneCallback ()">GnomeKeyringOperationDoneCallback</a> callback</code>,

365

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

366

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

364

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> gnome_keyring_lock_all (<code><a class="link" href="gnome-keyring-Callbacks.html#GnomeKeyringOperationDoneCallback" title="GnomeKeyringOperationDoneCallback ()">GnomeKeyringOperationDoneCallback</a> callback</code>,

365

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

366

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

367

368

Lock all the keyrings, so that their contents may not be accessed without

369

first unlocking them with a password.

421

<hr>

422

423

<a name="gnome-keyring-create"></a><h3>gnome_keyring_create ()</h3>

424

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> gnome_keyring_create (<code>const char *keyring_name</code>,

424

425

<code>const char *password</code>,

426

427

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

428

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

427

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

428

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

429

430

Create a new keyring with the specified name. In most cases <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be

430

Create a new keyring with the specified name. In most cases <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be

431

passed as the <code>password</code>, which will prompt the user to enter a password

432

of their choice.

433

439

<tbody>

440

<tr>

441

<td><code>keyring_name</code> :</td>

442

<td>The new keyring name. Must not be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>

442

<td>The new keyring name. Must not be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>

443

</tr>

444

<tr>

445

<td><code>password</code> :</td>

446

<td>The password for the new keyring. If <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> user

446

<td>The password for the new keyring. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> user

447

will be prompted. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

448

</td>

449

</tr>

476

477

<code>const char *password</code>);</pre>

478

479

Create a new keyring with the specified name. In most cases <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be

479

Create a new keyring with the specified name. In most cases <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be

480

passed in as the <code>password</code>, which will prompt the user to enter a password

481

of their choice.

482

488

<tbody>

489

<tr>

490

<td><code>keyring_name</code> :</td>

491

<td>The new keyring name. Must not be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

491

<td>The new keyring name. Must not be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

492

</td>

493

</tr>

494

<tr>

495

<td><code>password</code> :</td>

496

<td>The password for the new keyring. If <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> user

496

<td>The password for the new keyring. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> user

497

will be prompted. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

498

</td>

499

</tr>

509

<hr>

510

511

<a name="gnome-keyring-unlock"></a><h3>gnome_keyring_unlock ()</h3>

512

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> gnome_keyring_unlock (<code>const char *keyring</code>,

512

513

<code>const char *password</code>,

514

515

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

516

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

515

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

516

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

517

518

Unlock a <code>keyring</code>, so that its contents may be accessed. In most cases <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

518

Unlock a <code>keyring</code>, so that its contents may be accessed. In most cases <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

519

will be passed as the <code>password</code>, which will prompt the user to enter the

520

correct password.

521

531

<tbody>

532

<tr>

533

<td><code>keyring</code> :</td>

534

<td>The name of the keyring to unlock, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the

534

<td>The name of the keyring to unlock, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the

535

default keyring. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

536

</td>

537

</tr>

538

<tr>

539

<td><code>password</code> :</td>

540

<td>The password to unlock the keyring with, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

540

<td>The password to unlock the keyring with, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

541

to prompt the user. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

542

</td>

543

</tr>

570

571

<code>const char *password</code>);</pre>

572

573

574

will be passed in as the <code>password</code>, which will prompt the user to enter the

575

correct password.

576

586

<tbody>

587

<tr>

588

<td><code>keyring</code> :</td>

589

<td>The name of the keyring to unlock, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the

589

<td>The name of the keyring to unlock, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the

590

default keyring. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

591

</td>

592

</tr>

593

<tr>

594

<td><code>password</code> :</td>

595

<td>The password to unlock the keyring with, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

595

<td>The password to unlock the keyring with, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

596

to prompt the user. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

597

</td>

598

</tr>

608

<hr>

609

610

<a name="gnome-keyring-lock"></a><h3>gnome_keyring_lock ()</h3>

611

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> gnome_keyring_lock (<code>const char *keyring</code>,

611

612

613

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

614

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

613

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

614

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

615

616

Lock a <code>keyring</code>, so that its contents may not be accessed without first

617

supplying a password.

628

<tbody>

629

<tr>

630

<td><code>keyring</code> :</td>

631

<td>The name of the keyring to lock, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the

631

<td>The name of the keyring to lock, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the

632

default keyring. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

633

</td>

634

</tr>

675

<tbody>

676

<tr>

677

<td><code>keyring</code> :</td>

678

<td>The name of the keyring to lock, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the

678

<td>The name of the keyring to lock, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the

679

default keyring. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

680

</td>

681

</tr>

691

<hr>

692

693

<a name="gnome-keyring-delete"></a><h3>gnome_keyring_delete ()</h3>

694

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> gnome_keyring_delete (<code>const char *keyring</code>,

694

695

696

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

697

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

696

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

697

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

698

699

Delete <code>keyring</code>. Once a keyring is deleted there is no mechanism for

700

recovery of its contents.

707

<tbody>

708

<tr>

709

<td><code>keyring</code> :</td>

710

<td>The name of the keyring to delete. Cannot be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>

710

<td>The name of the keyring to delete. Cannot be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>

711

</tr>

712

<tr>

713

<td><code>callback</code> :</td>

748

<tbody>

749

<tr>

750

<td><code>keyring</code> :</td>

751

<td>The name of the keyring to delete. Cannot be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

751

<td>The name of the keyring to delete. Cannot be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

752

</td>

753

</tr>

754

<tr>

763

<hr>

764

765

<a name="gnome-keyring-get-info"></a><h3>gnome_keyring_get_info ()</h3>

766

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> gnome_keyring_get_info (<code>const char *keyring</code>,

766

767

768

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

769

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

768

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

769

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

770

771

Get information about the <code>keyring</code>. The resulting <a class="link" href="gnome-keyring-Keyring-Info.html#GnomeKeyringInfo" title="GnomeKeyringInfo">GnomeKeyringInfo</a> structure

772

will be passed to <code>callback</code>. The structure is freed after <code>callback</code> returns.

779

<tbody>

780

<tr>

781

<td><code>keyring</code> :</td>

782

<td>The name of the keyring, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the default

782

<td>The name of the keyring, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the default

783

keyring. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

784

</td>

785

</tr>

826

<tbody>

827

<tr>

828

<td><code>keyring</code> :</td>

829

<td>The name of the keyring, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the default

829

<td>The name of the keyring, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the default

830

keyring. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

831

</td>

832

</tr>

847

<hr>

848

849

<a name="gnome-keyring-set-info"></a><h3>gnome_keyring_set_info ()</h3>

850

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> gnome_keyring_set_info (<code>const char *keyring</code>,

850

851

<code><a class="link" href="gnome-keyring-Keyring-Info.html#GnomeKeyringInfo" title="GnomeKeyringInfo">GnomeKeyringInfo</a> *info</code>,

852

853

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

854

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

853

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

854

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

855

856

Set flags and info for the <code>keyring</code>. The only fields in <code>info</code> that are used

857

are lock_on_idle and lock_timeout.

864

<tbody>

865

<tr>

866

<td><code>keyring</code> :</td>

867

<td>The name of the keyring, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the default

867

<td>The name of the keyring, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the default

868

keyring. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

869

</td>

870

</tr>

912

<tbody>

913

<tr>

914

<td><code>keyring</code> :</td>

915

<td>The name of the keyring, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the default

915

<td>The name of the keyring, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the default

916

keyring. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

917

</td>

918

</tr>

932

<hr>

933

934

<a name="gnome-keyring-change-password"></a><h3>gnome_keyring_change_password ()</h3>

935

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> gnome_keyring_change_password (<code>const char *keyring</code>,

935

936

<code>const char *original</code>,

937

<code>const char *password</code>,

938

939

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

940

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

939

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

940

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

941

942

Change the password for a <code>keyring</code>. In most cases you would specify <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for

942

Change the password for a <code>keyring</code>. In most cases you would specify <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for

943

both the <code>original</code> and <code>password</code> arguments and allow the user to type the

944

correct passwords.

945

951

<tbody>

952

<tr>

953

<td><code>keyring</code> :</td>

954

<td>The name of the keyring to change the password for. Cannot be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>

954

<td>The name of the keyring to change the password for. Cannot be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>

955

</tr>

956

<tr>

957

<td><code>original</code> :</td>

958

<td>The old keyring password, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to prompt the

958

<td>The old keyring password, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to prompt the

959

user for it. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

960

</td>

961

</tr>

962

<tr>

963

<td><code>password</code> :</td>

964

<td>The new keyring password, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to prompt the

964

<td>The new keyring password, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to prompt the

965

user for it. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

966

</td>

967

</tr>

995

<code>const char *original</code>,

996

<code>const char *password</code>);</pre>

997

998

Change the password for <code>keyring</code>. In most cases you would specify <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for

998

Change the password for <code>keyring</code>. In most cases you would specify <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for

999

both the <code>original</code> and <code>password</code> arguments and allow the user to type the

1000

correct passwords.

1001

1007

<tbody>

1008

<tr>

1009

<td><code>keyring</code> :</td>

1010

<td>The name of the keyring to change the password for. Cannot be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

1010

<td>The name of the keyring to change the password for. Cannot be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

1011

</td>

1012

</tr>

1013

<tr>

1014

<td><code>original</code> :</td>

1015

<td>The old keyring password, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to prompt the

1015

<td>The old keyring password, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to prompt the

1016

user for it. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

1017

</td>

1018

</tr>

1019

<tr>

1020

<td><code>password</code> :</td>

1021

<td>The new keyring password, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to prompt the

1021

<td>The new keyring password, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to prompt the

1022

user for it. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

1023

</td>

1024

</tr>

1034

<hr>

1035

1036

<a name="gnome-keyring-list-item-ids"></a><h3>gnome_keyring_list_item_ids ()</h3>

1037

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> gnome_keyring_list_item_ids (<code>const char *keyring</code>,

1037

1038

1039

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

1040

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

1039

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

1040

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_data</code>);</pre>

1041

1042

Get a list of all the ids for items in <code>keyring</code>. These are passed in a <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><code class="literal">GList</code></a>

1043

to the <code>callback</code>. Use <a href="../glib/glib-Type-Conversion-Macros.html#GPOINTER-TO-UINT:CAPS"><code class="function">GPOINTER_TO_UINT()</code></a> on the list to access the integer ids.

1042

Get a list of all the ids for items in <code>keyring</code>. These are passed in a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><code class="literal">GList</code></a>

1043

to the <code>callback</code>. Use <a href="http://library.gnome.org/devel/glib/unstable/glib-Type-Conversion-Macros.html#GPOINTER-TO-UINT:CAPS"><code class="function">GPOINTER_TO_UINT()</code></a> on the list to access the integer ids.

1044

The list is freed after <code>callback</code> returns.

1045

1046

1056

<tbody>

1057

<tr>

1058

<td><code>keyring</code> :</td>

1059

<td>The name of the keyring, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the default

1059

<td>The name of the keyring, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the default

1060

keyring. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

1061

</td>

1062

</tr>

1087

1088

<a name="gnome-keyring-list-item-ids-sync"></a><h3>gnome_keyring_list_item_ids_sync ()</h3>

1089

1090

<code><a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> **ids</code>);</pre>

1090

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> **ids</code>);</pre>

1091

1092

Get a list of all the ids for items in <code>keyring</code>.

1093

1094

1095

Use <a href="../glib/glib-Type-Conversion-Macros.html#GPOINTER-TO-UINT:CAPS"><code class="function">GPOINTER_TO_UINT()</code></a> on the list to access the integer ids. The list

1096

should be freed with <a href="../glib/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a>.

1095

Use <a href="http://library.gnome.org/devel/glib/unstable/glib-Type-Conversion-Macros.html#GPOINTER-TO-UINT:CAPS"><code class="function">GPOINTER_TO_UINT()</code></a> on the list to access the integer ids. The list

1096

should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a>.

1097

1098

1099

For an asynchronous version of this function see <a class="link" href="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>.

1103

<tbody>

1104

<tr>

1105

<td><code>keyring</code> :</td>

1106

<td>The name of the keyring, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the default

1106

<td>The name of the keyring, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the default

1107

keyring. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

1108

</td>

1109

</tr>

1110

<tr>

1111

1112

<td>The location to store a <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><code class="literal">GList</code></a> of item ids

1112

<td>The location to store a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><code class="literal">GList</code></a> of item ids

1113

(ie: unsigned integers). [<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>][<acronym title="Generics and defining elements of containers and arrays.">element-type</acronym> guint]

1114

</td>

1115

</tr>

Older »