| Current File : //proc/self/root/kunden/usr/share/gtk-doc/html/libsecret-1/SecretService.html |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>SecretService: Libsecret Library Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="Libsecret Library Reference Manual">
<link rel="up" href="complete.html" title="Part III. Complete API">
<link rel="prev" href="complete.html" title="Part III. Complete API">
<link rel="next" href="SecretCollection.html" title="SecretCollection">
<meta name="generator" content="GTK-Doc V1.32 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
<a href="#SecretService.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
<a href="#SecretService.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces"> <span class="dim">|</span>
<a href="#SecretService.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties"> <span class="dim">|</span>
<a href="#SecretService.properties" class="shortcut">Properties</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="complete.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="complete.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="SecretCollection.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="SecretService"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="SecretService.top_of_page"></a>SecretService</span></h2>
<p>SecretService — the Secret Service</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="SecretService.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_proto_type">
<col class="functions_proto_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-get" title="secret_service_get ()">secret_service_get</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="SecretService.html" title="SecretService"><span class="returnvalue">SecretService</span></a> *
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-get-sync" title="secret_service_get_sync ()">secret_service_get_sync</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="SecretService.html" title="SecretService"><span class="returnvalue">SecretService</span></a> *
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-get-finish" title="secret_service_get_finish ()">secret_service_get_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-disconnect" title="secret_service_disconnect ()">secret_service_disconnect</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-open" title="secret_service_open ()">secret_service_open</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="SecretService.html" title="SecretService"><span class="returnvalue">SecretService</span></a> *
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-open-finish" title="secret_service_open_finish ()">secret_service_open_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="SecretService.html" title="SecretService"><span class="returnvalue">SecretService</span></a> *
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-open-sync" title="secret_service_open_sync ()">secret_service_open_sync</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-get-collections" title="secret_service_get_collections ()">secret_service_get_collections</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="SecretService.html#SecretServiceFlags" title="enum SecretServiceFlags"><span class="returnvalue">SecretServiceFlags</span></a>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-get-flags" title="secret_service_get_flags ()">secret_service_get_flags</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-get-session-algorithms" title="secret_service_get_session_algorithms ()">secret_service_get_session_algorithms</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-ensure-session" title="secret_service_ensure_session ()">secret_service_ensure_session</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-ensure-session-finish" title="secret_service_ensure_session_finish ()">secret_service_ensure_session_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-ensure-session-sync" title="secret_service_ensure_session_sync ()">secret_service_ensure_session_sync</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-load-collections" title="secret_service_load_collections ()">secret_service_load_collections</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-load-collections-finish" title="secret_service_load_collections_finish ()">secret_service_load_collections_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-load-collections-sync" title="secret_service_load_collections_sync ()">secret_service_load_collections_sync</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-search" title="secret_service_search ()">secret_service_search</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-search-finish" title="secret_service_search_finish ()">secret_service_search_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-search-sync" title="secret_service_search_sync ()">secret_service_search_sync</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-lock" title="secret_service_lock ()">secret_service_lock</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-lock-finish" title="secret_service_lock_finish ()">secret_service_lock_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-lock-sync" title="secret_service_lock_sync ()">secret_service_lock_sync</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-unlock" title="secret_service_unlock ()">secret_service_unlock</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-unlock-finish" title="secret_service_unlock_finish ()">secret_service_unlock_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-unlock-sync" title="secret_service_unlock_sync ()">secret_service_unlock_sync</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-store" title="secret_service_store ()">secret_service_store</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-store-finish" title="secret_service_store_finish ()">secret_service_store_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-store-sync" title="secret_service_store_sync ()">secret_service_store_sync</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-lookup" title="secret_service_lookup ()">secret_service_lookup</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="SecretValue.html" title="SecretValue"><span class="returnvalue">SecretValue</span></a> *
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-lookup-finish" title="secret_service_lookup_finish ()">secret_service_lookup_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="SecretValue.html" title="SecretValue"><span class="returnvalue">SecretValue</span></a> *
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-lookup-sync" title="secret_service_lookup_sync ()">secret_service_lookup_sync</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-clear" title="secret_service_clear ()">secret_service_clear</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-clear-finish" title="secret_service_clear_finish ()">secret_service_clear_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-clear-sync" title="secret_service_clear_sync ()">secret_service_clear_sync</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-prompt" title="secret_service_prompt ()">secret_service_prompt</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-prompt-finish" title="secret_service_prompt_finish ()">secret_service_prompt_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-prompt-sync" title="secret_service_prompt_sync ()">secret_service_prompt_sync</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-set-alias" title="secret_service_set_alias ()">secret_service_set_alias</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-set-alias-finish" title="secret_service_set_alias_finish ()">secret_service_set_alias_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-set-alias-sync" title="secret_service_set_alias_sync ()">secret_service_set_alias_sync</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-get-collection-gtype" title="secret_service_get_collection_gtype ()">secret_service_get_collection_gtype</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>
</td>
<td class="function_name">
<a class="link" href="SecretService.html#secret-service-get-item-gtype" title="secret_service_get_item_gtype ()">secret_service_get_item_gtype</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="SecretService.properties"></a><h2>Properties</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="properties_type">
<col width="300px" class="properties_name">
<col width="200px" class="properties_flags">
</colgroup>
<tbody><tr>
<td class="property_type">
<span class="type">SecretObjectList</span> *</td>
<td class="property_name"><a class="link" href="SecretService.html#SecretService--collections" title="The “collections” property">collections</a></td>
<td class="property_flags">Read</td>
</tr></tbody>
</table></div>
</div>
<div class="refsect1">
<a name="SecretService.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="other_proto_type">
<col class="other_proto_name">
</colgroup>
<tbody>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="SecretService.html#SecretService-struct" title="struct SecretService">SecretService</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="SecretService.html#SecretServiceClass" title="struct SecretServiceClass">SecretServiceClass</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="SecretService.html#SecretServiceFlags" title="enum SecretServiceFlags">SecretServiceFlags</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="SecretService.html#SecretSearchFlags" title="enum SecretSearchFlags">SecretSearchFlags</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="SecretService.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html">GFlags</a>
<span class="lineart">╰──</span> SecretServiceFlags
<a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
<span class="lineart">╰──</span> <a href="/usr/share/gtk-doc/html/gio/GDBusProxy.html#GDBusProxy-struct">GDBusProxy</a>
<span class="lineart">╰──</span> SecretService
</pre>
</div>
<div class="refsect1">
<a name="SecretService.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
SecretService implements
<a href="/usr/share/gtk-doc/html/gio/GDBusInterface.html#GDBusInterface-struct">GDBusInterface</a>, <a href="/usr/share/gtk-doc/html/gio/GInitable.html#GInitable-struct">GInitable</a>, <a href="/usr/share/gtk-doc/html/gio/GAsyncInitable.html#GAsyncInitable-struct">GAsyncInitable</a> and SecretBackend.</p>
</div>
<div class="refsect1">
<a name="SecretService.includes"></a><h2>Includes</h2>
<pre class="synopsis">#include <libsecret/secret.h>
</pre>
</div>
<div class="refsect1">
<a name="SecretService.description"></a><h2>Description</h2>
<p>A <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> object represents the Secret Service implementation which
runs as a D-Bus service.</p>
<p>Normally a single <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> object can be shared between multiple
callers. The <a class="link" href="SecretService.html#secret-service-get" title="secret_service_get ()"><code class="function">secret_service_get()</code></a> method is used to access this <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a>
object. If a new independent <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> object is required, use
<a class="link" href="SecretService.html#secret-service-open" title="secret_service_open ()"><code class="function">secret_service_open()</code></a>.</p>
<p>In order to securely transfer secrets to the Sercret Service, a session
is established. This session can be established while initializing a
<a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> object by passing the <a class="link" href="SecretService.html#SECRET-SERVICE-OPEN-SESSION:CAPS"><code class="literal">SECRET_SERVICE_OPEN_SESSION</code></a> flag
to the <a class="link" href="SecretService.html#secret-service-get" title="secret_service_get ()"><code class="function">secret_service_get()</code></a> or <a class="link" href="SecretService.html#secret-service-open" title="secret_service_open ()"><code class="function">secret_service_open()</code></a> functions. In order to
establish a session on an already existing <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a>, use the
<a class="link" href="SecretService.html#secret-service-ensure-session" title="secret_service_ensure_session ()"><code class="function">secret_service_ensure_session()</code></a> function.</p>
<p>To search for items, use the <a class="link" href="SecretService.html#secret-service-search" title="secret_service_search ()"><code class="function">secret_service_search()</code></a> method.</p>
<p>Multiple collections can exist in the Secret Service, each of which contains
secret items. In order to instantiate <a class="link" href="SecretCollection.html" title="SecretCollection"><span class="type">SecretCollection</span></a> objects which
represent those collections while initializing a <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> then pass
the <a class="link" href="SecretService.html#SECRET-SERVICE-LOAD-COLLECTIONS:CAPS"><code class="literal">SECRET_SERVICE_LOAD_COLLECTIONS</code></a> flag to the <a class="link" href="SecretService.html#secret-service-get" title="secret_service_get ()"><code class="function">secret_service_get()</code></a> or
<a class="link" href="SecretService.html#secret-service-open" title="secret_service_open ()"><code class="function">secret_service_open()</code></a> functions. In order to establish a session on an already
existing <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a>, use the <a class="link" href="SecretService.html#secret-service-load-collections" title="secret_service_load_collections ()"><code class="function">secret_service_load_collections()</code></a> function.
To access the list of collections use <a class="link" href="SecretService.html#secret-service-get-collections" title="secret_service_get_collections ()"><code class="function">secret_service_get_collections()</code></a>.</p>
<p>Certain actions on the Secret Service require user prompting to complete,
such as creating a collection, or unlocking a collection. When such a prompt
is necessary, then a <a class="link" href="SecretPrompt.html" title="SecretPrompt"><span class="type">SecretPrompt</span></a> object is created by this library, and
passed to the <a class="link" href="SecretService.html#secret-service-prompt" title="secret_service_prompt ()"><code class="function">secret_service_prompt()</code></a> method. In this way it is handled
automatically.</p>
<p>In order to customize prompt handling, override the <code class="literal">prompt_async</code>
and <code class="literal">prompt_finish</code> virtual methods of the <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> class.</p>
</div>
<div class="refsect1">
<a name="SecretService.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="secret-service-get"></a><h3>secret_service_get ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
secret_service_get (<em class="parameter"><code><a class="link" href="SecretService.html#SecretServiceFlags" title="enum SecretServiceFlags"><span class="type">SecretServiceFlags</span></a> flags</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<p>Get a <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy for the Secret Service. If such a proxy object
already exists, then the same proxy is returned.</p>
<p>If <em class="parameter"><code>flags</code></em>
contains any flags of which parts of the secret service to
ensure are initialized, then those will be initialized before completing.</p>
<p>This method will return immediately and complete asynchronously.</p>
<div class="refsect3">
<a name="secret-service-get.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>flags</p></td>
<td class="parameter_description"><p>flags for which service functionality to ensure is initialized</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>called when the operation completes</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>data to be passed to the callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-get-sync"></a><h3>secret_service_get_sync ()</h3>
<pre class="programlisting"><a class="link" href="SecretService.html" title="SecretService"><span class="returnvalue">SecretService</span></a> *
secret_service_get_sync (<em class="parameter"><code><a class="link" href="SecretService.html#SecretServiceFlags" title="enum SecretServiceFlags"><span class="type">SecretServiceFlags</span></a> flags</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Get a <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy for the Secret Service. If such a proxy object
already exists, then the same proxy is returned.</p>
<p>If <em class="parameter"><code>flags</code></em>
contains any flags of which parts of the secret service to
ensure are initialized, then those will be initialized before returning.</p>
<p>This method may block indefinitely and should not be used in user interface
threads.</p>
<div class="refsect3">
<a name="secret-service-get-sync.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>flags</p></td>
<td class="parameter_description"><p>flags for which service functionality to ensure is initialized</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place an error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-get-sync.returns"></a><h4>Returns</h4>
<p>a new reference to a <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy, which
should be released with <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-get-finish"></a><h3>secret_service_get_finish ()</h3>
<pre class="programlisting"><a class="link" href="SecretService.html" title="SecretService"><span class="returnvalue">SecretService</span></a> *
secret_service_get_finish (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> *result</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Complete an asynchronous operation to get a <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy for the
Secret Service.</p>
<div class="refsect3">
<a name="secret-service-get-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>result</p></td>
<td class="parameter_description"><p>the asynchronous result passed to the callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place an error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-get-finish.returns"></a><h4>Returns</h4>
<p>a new reference to a <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy, which
should be released with <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-disconnect"></a><h3>secret_service_disconnect ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
secret_service_disconnect (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>Disconnect the default <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy returned by <a class="link" href="SecretService.html#secret-service-get" title="secret_service_get ()"><code class="function">secret_service_get()</code></a>
and <a class="link" href="SecretService.html#secret-service-get-sync" title="secret_service_get_sync ()"><code class="function">secret_service_get_sync()</code></a>.</p>
<p>It is not necessary to call this function, but you may choose to do so at
program exit. It is useful for testing that memory is not leaked.</p>
<p>This function is safe to call at any time. But if other objects in this
library are still referenced, then this will not result in all memory
being freed.</p>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-open"></a><h3>secret_service_open ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
secret_service_open (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> service_gtype</code></em>,
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *service_bus_name</code></em>,
<em class="parameter"><code><a class="link" href="SecretService.html#SecretServiceFlags" title="enum SecretServiceFlags"><span class="type">SecretServiceFlags</span></a> flags</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<p>Create a new <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy for the Secret Service.</p>
<p>This function is rarely used, see <a class="link" href="SecretService.html#secret-service-get" title="secret_service_get ()"><code class="function">secret_service_get()</code></a> instead.</p>
<p>The <em class="parameter"><code>service_gtype</code></em>
argument should be set to <code class="literal">SECRET_TYPE_SERVICE</code> or a the type
of a derived class.</p>
<p>If <em class="parameter"><code>flags</code></em>
contains any flags of which parts of the secret service to
ensure are initialized, then those will be initialized before returning.</p>
<p>If <em class="parameter"><code>service_bus_name</code></em>
is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the default is used.</p>
<p>This method will return immediately and complete asynchronously.</p>
<div class="refsect3">
<a name="secret-service-open.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service_gtype</p></td>
<td class="parameter_description"><p>the GType of the new secret service</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>service_bus_name</p></td>
<td class="parameter_description"><p>the D-Bus service name of the secret service. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>flags</p></td>
<td class="parameter_description"><p>flags for which service functionality to ensure is initialized</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>called when the operation completes</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>data to be passed to the callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-open-finish"></a><h3>secret_service_open_finish ()</h3>
<pre class="programlisting"><a class="link" href="SecretService.html" title="SecretService"><span class="returnvalue">SecretService</span></a> *
secret_service_open_finish (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> *result</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Complete an asynchronous operation to create a new <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy for
the Secret Service.</p>
<div class="refsect3">
<a name="secret-service-open-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>result</p></td>
<td class="parameter_description"><p>the asynchronous result passed to the callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place an error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-open-finish.returns"></a><h4>Returns</h4>
<p>a new reference to a <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy, which
should be released with <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-open-sync"></a><h3>secret_service_open_sync ()</h3>
<pre class="programlisting"><a class="link" href="SecretService.html" title="SecretService"><span class="returnvalue">SecretService</span></a> *
secret_service_open_sync (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> service_gtype</code></em>,
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *service_bus_name</code></em>,
<em class="parameter"><code><a class="link" href="SecretService.html#SecretServiceFlags" title="enum SecretServiceFlags"><span class="type">SecretServiceFlags</span></a> flags</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Create a new <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy for the Secret Service.</p>
<p>This function is rarely used, see <a class="link" href="SecretService.html#secret-service-get-sync" title="secret_service_get_sync ()"><code class="function">secret_service_get_sync()</code></a> instead.</p>
<p>The <em class="parameter"><code>service_gtype</code></em>
argument should be set to <code class="literal">SECRET_TYPE_SERVICE</code> or a the
type of a derived class.</p>
<p>If <em class="parameter"><code>flags</code></em>
contains any flags of which parts of the secret service to
ensure are initialized, then those will be initialized before returning.</p>
<p>If <em class="parameter"><code>service_bus_name</code></em>
is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the default is used.</p>
<p>This method may block indefinitely and should not be used in user interface
threads.</p>
<div class="refsect3">
<a name="secret-service-open-sync.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service_gtype</p></td>
<td class="parameter_description"><p>the GType of the new secret service</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>service_bus_name</p></td>
<td class="parameter_description"><p>the D-Bus service name of the secret service. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>flags</p></td>
<td class="parameter_description"><p>flags for which service functionality to ensure is initialized</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place an error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-open-sync.returns"></a><h4>Returns</h4>
<p>a new reference to a <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy, which
should be released with <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-get-collections"></a><h3>secret_service_get_collections ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
secret_service_get_collections (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *self</code></em>);</pre>
<p>Get a list of <a class="link" href="SecretCollection.html" title="SecretCollection"><span class="type">SecretCollection</span></a> objects representing all the collections
in the secret service.</p>
<p>If the <a class="link" href="SecretService.html#SECRET-SERVICE-LOAD-COLLECTIONS:CAPS"><code class="literal">SECRET_SERVICE_LOAD_COLLECTIONS</code></a> flag was not specified when
initializing <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy object, then this method will return
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Use <a class="link" href="SecretService.html#secret-service-load-collections" title="secret_service_load_collections ()"><code class="function">secret_service_load_collections()</code></a> to load the collections.</p>
<div class="refsect3">
<a name="secret-service-get-collections.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>the secret service proxy</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-get-collections.returns"></a><h4>Returns</h4>
<p>a
list of the collections in the secret service. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Secret.Collection][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-get-flags"></a><h3>secret_service_get_flags ()</h3>
<pre class="programlisting"><a class="link" href="SecretService.html#SecretServiceFlags" title="enum SecretServiceFlags"><span class="returnvalue">SecretServiceFlags</span></a>
secret_service_get_flags (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *self</code></em>);</pre>
<p>Get the flags representing what features of the <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy
have been initialized.</p>
<p>Use <a class="link" href="SecretService.html#secret-service-ensure-session" title="secret_service_ensure_session ()"><code class="function">secret_service_ensure_session()</code></a> or <a class="link" href="SecretService.html#secret-service-load-collections" title="secret_service_load_collections ()"><code class="function">secret_service_load_collections()</code></a>
to initialize further features and change the flags.</p>
<div class="refsect3">
<a name="secret-service-get-flags.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>the secret service proxy</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-get-flags.returns"></a><h4>Returns</h4>
<p> the flags for features initialized</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-get-session-algorithms"></a><h3>secret_service_get_session_algorithms ()</h3>
<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
secret_service_get_session_algorithms (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *self</code></em>);</pre>
<p>Get the set of algorithms being used to transfer secrets between this
secret service proxy and the Secret Service itself.</p>
<p>This will be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no session has been established. Use
<a class="link" href="SecretService.html#secret-service-ensure-session" title="secret_service_ensure_session ()"><code class="function">secret_service_ensure_session()</code></a> to establish a session.</p>
<div class="refsect3">
<a name="secret-service-get-session-algorithms.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>the secret service proxy</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-get-session-algorithms.returns"></a><h4>Returns</h4>
<p>a string representing the algorithms for transferring
secrets. </p>
<p><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-ensure-session"></a><h3>secret_service_ensure_session ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
secret_service_ensure_session (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *self</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<p>Ensure that the <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy has established a session with the
Secret Service. This session is used to transfer secrets.</p>
<p>It is not normally necessary to call this method, as the session is
established as necessary. You can also pass the <a class="link" href="SecretService.html#SECRET-SERVICE-OPEN-SESSION:CAPS"><code class="literal">SECRET_SERVICE_OPEN_SESSION</code></a>
to <a class="link" href="SecretService.html#secret-service-get" title="secret_service_get ()"><code class="function">secret_service_get()</code></a> in order to ensure that a session has been established
by the time you get the <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy.</p>
<p>This method will return immediately and complete asynchronously.</p>
<div class="refsect3">
<a name="secret-service-ensure-session.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>the secret service</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>called when the operation completes</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>data to be passed to the callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-ensure-session-finish"></a><h3>secret_service_ensure_session_finish ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
secret_service_ensure_session_finish (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *self</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> *result</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Finish an asynchronous operation to ensure that the <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy
has established a session with the Secret Service.</p>
<div class="refsect3">
<a name="secret-service-ensure-session-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>the secret service</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>result</p></td>
<td class="parameter_description"><p>the asynchronous result passed to the callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place an error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-ensure-session-finish.returns"></a><h4>Returns</h4>
<p> whether a session is established or not</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-ensure-session-sync"></a><h3>secret_service_ensure_session_sync ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
secret_service_ensure_session_sync (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *self</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Ensure that the <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy has established a session with the
Secret Service. This session is used to transfer secrets.</p>
<p>It is not normally necessary to call this method, as the session is
established as necessary. You can also pass the <a class="link" href="SecretService.html#SECRET-SERVICE-OPEN-SESSION:CAPS"><code class="literal">SECRET_SERVICE_OPEN_SESSION</code></a>
to <a class="link" href="SecretService.html#secret-service-get-sync" title="secret_service_get_sync ()"><code class="function">secret_service_get_sync()</code></a> in order to ensure that a session has been
established by the time you get the <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy.</p>
<p>This method may block indefinitely and should not be used in user interface
threads.</p>
<div class="refsect3">
<a name="secret-service-ensure-session-sync.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>the secret service</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place an error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-ensure-session-sync.returns"></a><h4>Returns</h4>
<p> whether a session is established or not</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-load-collections"></a><h3>secret_service_load_collections ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
secret_service_load_collections (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *self</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<p>Ensure that the <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy has loaded all the collections present
in the Secret Service. This affects the result of
<a class="link" href="SecretService.html#secret-service-get-collections" title="secret_service_get_collections ()"><code class="function">secret_service_get_collections()</code></a>.</p>
<p>You can also pass the <a class="link" href="SecretService.html#SECRET-SERVICE-LOAD-COLLECTIONS:CAPS"><code class="literal">SECRET_SERVICE_LOAD_COLLECTIONS</code></a> to
<a class="link" href="SecretService.html#secret-service-get-sync" title="secret_service_get_sync ()"><code class="function">secret_service_get_sync()</code></a> in order to ensure that the collections have been
loaded by the time you get the <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy.</p>
<p>This method will return immediately and complete asynchronously.</p>
<div class="refsect3">
<a name="secret-service-load-collections.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>the secret service</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>called when the operation completes</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>data to be passed to the callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-load-collections-finish"></a><h3>secret_service_load_collections_finish ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
secret_service_load_collections_finish
(<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *self</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> *result</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Complete an asynchronous operation to ensure that the <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy
has loaded all the collections present in the Secret Service.</p>
<div class="refsect3">
<a name="secret-service-load-collections-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>the secret service</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>result</p></td>
<td class="parameter_description"><p>the asynchronous result passed to the callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place an error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-load-collections-finish.returns"></a><h4>Returns</h4>
<p> whether the load was successful or not</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-load-collections-sync"></a><h3>secret_service_load_collections_sync ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
secret_service_load_collections_sync (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *self</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Ensure that the <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy has loaded all the collections present
in the Secret Service. This affects the result of
<a class="link" href="SecretService.html#secret-service-get-collections" title="secret_service_get_collections ()"><code class="function">secret_service_get_collections()</code></a>.</p>
<p>You can also pass the <a class="link" href="SecretService.html#SECRET-SERVICE-LOAD-COLLECTIONS:CAPS"><code class="literal">SECRET_SERVICE_LOAD_COLLECTIONS</code></a> to
<a class="link" href="SecretService.html#secret-service-get-sync" title="secret_service_get_sync ()"><code class="function">secret_service_get_sync()</code></a> in order to ensure that the collections have been
loaded by the time you get the <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy.</p>
<p>This method may block indefinitely and should not be used in user interface
threads.</p>
<div class="refsect3">
<a name="secret-service-load-collections-sync.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>the secret service</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place an error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-load-collections-sync.returns"></a><h4>Returns</h4>
<p> whether the load was successful or not</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-search"></a><h3>secret_service_search ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
secret_service_search (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *service</code></em>,
<em class="parameter"><code>const <a class="link" href="libsecret-SecretSchema.html#SecretSchema" title="SecretSchema"><span class="type">SecretSchema</span></a> *schema</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *attributes</code></em>,
<em class="parameter"><code><a class="link" href="SecretService.html#SecretSearchFlags" title="enum SecretSearchFlags"><span class="type">SecretSearchFlags</span></a> flags</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<p>Search for items matching the <em class="parameter"><code>attributes</code></em>
. All collections are searched.
The <em class="parameter"><code>attributes</code></em>
should be a table of string keys and string values.</p>
<p>If <em class="parameter"><code>service</code></em>
is NULL, then <a class="link" href="SecretService.html#secret-service-get" title="secret_service_get ()"><code class="function">secret_service_get()</code></a> will be called to get
the default <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy.</p>
<p>If <a class="link" href="SecretService.html#SECRET-SEARCH-ALL:CAPS"><code class="literal">SECRET_SEARCH_ALL</code></a> is set in <em class="parameter"><code>flags</code></em>
, then all the items matching the
search will be returned. Otherwise only the first item will be returned.
This is almost always the unlocked item that was most recently stored.</p>
<p>If <a class="link" href="SecretService.html#SECRET-SEARCH-UNLOCK:CAPS"><code class="literal">SECRET_SEARCH_UNLOCK</code></a> is set in <em class="parameter"><code>flags</code></em>
, then items will be unlocked
if necessary. In either case, locked and unlocked items will match the
search and be returned. If the unlock fails, the search does not fail.</p>
<p>If <a class="link" href="SecretService.html#SECRET-SEARCH-LOAD-SECRETS:CAPS"><code class="literal">SECRET_SEARCH_LOAD_SECRETS</code></a> is set in <em class="parameter"><code>flags</code></em>
, then the items will have
their secret values loaded and available via <a class="link" href="SecretItem.html#secret-item-get-secret" title="secret_item_get_secret ()"><code class="function">secret_item_get_secret()</code></a>.</p>
<p>This function returns immediately and completes asynchronously.</p>
<div class="refsect3">
<a name="secret-service-search.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>the secret service. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>schema</p></td>
<td class="parameter_description"><p>the schema for the attributes. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>attributes</p></td>
<td class="parameter_description"><p>search for items matching these attributes. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 utf8]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>flags</p></td>
<td class="parameter_description"><p>search option flags</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>called when the operation completes</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>data to pass to the callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-search-finish"></a><h3>secret_service_search_finish ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
secret_service_search_finish (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *service</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> *result</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Complete asynchronous operation to search for items.</p>
<div class="refsect3">
<a name="secret-service-search-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>the secret service. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>result</p></td>
<td class="parameter_description"><p>asynchronous result passed to callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-search-finish.returns"></a><h4>Returns</h4>
<p>a list of items that matched the search. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Secret.Item]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-search-sync"></a><h3>secret_service_search_sync ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
secret_service_search_sync (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *service</code></em>,
<em class="parameter"><code>const <a class="link" href="libsecret-SecretSchema.html#SecretSchema" title="SecretSchema"><span class="type">SecretSchema</span></a> *schema</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *attributes</code></em>,
<em class="parameter"><code><a class="link" href="SecretService.html#SecretSearchFlags" title="enum SecretSearchFlags"><span class="type">SecretSearchFlags</span></a> flags</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Search for items matching the <em class="parameter"><code>attributes</code></em>
. All collections are searched.
The <em class="parameter"><code>attributes</code></em>
should be a table of string keys and string values.</p>
<p>If <em class="parameter"><code>service</code></em>
is NULL, then <a class="link" href="SecretService.html#secret-service-get-sync" title="secret_service_get_sync ()"><code class="function">secret_service_get_sync()</code></a> will be called to get
the default <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy.</p>
<p>If <a class="link" href="SecretService.html#SECRET-SEARCH-ALL:CAPS"><code class="literal">SECRET_SEARCH_ALL</code></a> is set in <em class="parameter"><code>flags</code></em>
, then all the items matching the
search will be returned. Otherwise only the first item will be returned.
This is almost always the unlocked item that was most recently stored.</p>
<p>If <a class="link" href="SecretService.html#SECRET-SEARCH-UNLOCK:CAPS"><code class="literal">SECRET_SEARCH_UNLOCK</code></a> is set in <em class="parameter"><code>flags</code></em>
, then items will be unlocked
if necessary. In either case, locked and unlocked items will match the
search and be returned. If the unlock fails, the search does not fail.</p>
<p>If <a class="link" href="SecretService.html#SECRET-SEARCH-LOAD-SECRETS:CAPS"><code class="literal">SECRET_SEARCH_LOAD_SECRETS</code></a> is set in <em class="parameter"><code>flags</code></em>
, then the items' secret
values will be loaded for any unlocked items. Loaded item secret values
are available via <a class="link" href="SecretItem.html#secret-item-get-secret" title="secret_item_get_secret ()"><code class="function">secret_item_get_secret()</code></a>. If the load of a secret values
fail, then the</p>
<p>This function may block indefinitely. Use the asynchronous version
in user interface threads.</p>
<div class="refsect3">
<a name="secret-service-search-sync.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>the secret service. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>schema</p></td>
<td class="parameter_description"><p>the schema for the attributes. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>attributes</p></td>
<td class="parameter_description"><p>search for items matching these attributes. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 utf8]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>flags</p></td>
<td class="parameter_description"><p>search option flags</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-search-sync.returns"></a><h4>Returns</h4>
<p>a list of items that matched the search. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Secret.Item]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-lock"></a><h3>secret_service_lock ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
secret_service_lock (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *service</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *objects</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<p>Lock items or collections in the secret service.</p>
<p>The secret service may not be able to lock items individually, and may
lock an entire collection instead.</p>
<p>If <em class="parameter"><code>service</code></em>
is NULL, then <a class="link" href="SecretService.html#secret-service-get" title="secret_service_get ()"><code class="function">secret_service_get()</code></a> will be called to get
the default <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy.</p>
<p>This method returns immediately and completes asynchronously. The secret
service may prompt the user. <a class="link" href="SecretService.html#secret-service-prompt" title="secret_service_prompt ()"><code class="function">secret_service_prompt()</code></a> will be used to handle
any prompts that show up.</p>
<div class="refsect3">
<a name="secret-service-lock.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>the secret service. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>objects</p></td>
<td class="parameter_description"><p>the items or collections to lock. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Gio.DBusProxy]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>called when the operation completes</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>data to pass to the callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-lock-finish"></a><h3>secret_service_lock_finish ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
secret_service_lock_finish (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *service</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> *result</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> **locked</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Complete asynchronous operation to lock items or collections in the secret
service.</p>
<p>The secret service may not be able to lock items individually, and may
lock an entire collection instead.</p>
<div class="refsect3">
<a name="secret-service-lock-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>the secret service. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>result</p></td>
<td class="parameter_description"><p>asynchronous result passed to the callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>locked</p></td>
<td class="parameter_description"><p>location to place list of items or collections that were locked. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Gio.DBusProxy][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place an error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-lock-finish.returns"></a><h4>Returns</h4>
<p> the number of items or collections that were locked</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-lock-sync"></a><h3>secret_service_lock_sync ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
secret_service_lock_sync (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *service</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *objects</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> **locked</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Lock items or collections in the secret service.</p>
<p>The secret service may not be able to lock items individually, and may
lock an entire collection instead.</p>
<p>If <em class="parameter"><code>service</code></em>
is NULL, then <a class="link" href="SecretService.html#secret-service-get-sync" title="secret_service_get_sync ()"><code class="function">secret_service_get_sync()</code></a> will be called to get
the default <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy.</p>
<p>This method may block indefinitely and should not be used in user
interface threads. The secret service may prompt the user.
<a class="link" href="SecretService.html#secret-service-prompt" title="secret_service_prompt ()"><code class="function">secret_service_prompt()</code></a> will be used to handle any prompts that show up.</p>
<div class="refsect3">
<a name="secret-service-lock-sync.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>the secret service. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>objects</p></td>
<td class="parameter_description"><p>the items or collections to lock. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Gio.DBusProxy]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>locked</p></td>
<td class="parameter_description"><p>location to place list of items or collections that were locked. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Gio.DBusProxy][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place an error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-lock-sync.returns"></a><h4>Returns</h4>
<p> the number of items or collections that were locked</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-unlock"></a><h3>secret_service_unlock ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
secret_service_unlock (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *service</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *objects</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<p>Unlock items or collections in the secret service.</p>
<p>The secret service may not be able to unlock items individually, and may
unlock an entire collection instead.</p>
<p>If <em class="parameter"><code>service</code></em>
is NULL, then <a class="link" href="SecretService.html#secret-service-get" title="secret_service_get ()"><code class="function">secret_service_get()</code></a> will be called to get
the default <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy.</p>
<p>This method may block indefinitely and should not be used in user
interface threads. The secret service may prompt the user.
<a class="link" href="SecretService.html#secret-service-prompt" title="secret_service_prompt ()"><code class="function">secret_service_prompt()</code></a> will be used to handle any prompts that show up.</p>
<div class="refsect3">
<a name="secret-service-unlock.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>the secret service. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>objects</p></td>
<td class="parameter_description"><p>the items or collections to unlock. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Gio.DBusProxy]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>called when the operation completes</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>data to pass to the callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-unlock-finish"></a><h3>secret_service_unlock_finish ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
secret_service_unlock_finish (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *service</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> *result</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> **unlocked</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Complete asynchronous operation to unlock items or collections in the secret
service.</p>
<p>The secret service may not be able to unlock items individually, and may
unlock an entire collection instead.</p>
<div class="refsect3">
<a name="secret-service-unlock-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>the secret service. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>result</p></td>
<td class="parameter_description"><p>asynchronous result passed to the callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>unlocked</p></td>
<td class="parameter_description"><p>location to place list of items or collections that were unlocked. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Gio.DBusProxy][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place an error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-unlock-finish.returns"></a><h4>Returns</h4>
<p> the number of items or collections that were unlocked</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-unlock-sync"></a><h3>secret_service_unlock_sync ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
secret_service_unlock_sync (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *service</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *objects</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> **unlocked</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Unlock items or collections in the secret service.</p>
<p>The secret service may not be able to unlock items individually, and may
unlock an entire collection instead.</p>
<p>If <em class="parameter"><code>service</code></em>
is NULL, then <a class="link" href="SecretService.html#secret-service-get-sync" title="secret_service_get_sync ()"><code class="function">secret_service_get_sync()</code></a> will be called to get
the default <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy.</p>
<p>This method may block indefinitely and should not be used in user
interface threads. The secret service may prompt the user.
<a class="link" href="SecretService.html#secret-service-prompt" title="secret_service_prompt ()"><code class="function">secret_service_prompt()</code></a> will be used to handle any prompts that show up.</p>
<div class="refsect3">
<a name="secret-service-unlock-sync.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>the secret service. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>objects</p></td>
<td class="parameter_description"><p>the items or collections to unlock. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Gio.DBusProxy]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>unlocked</p></td>
<td class="parameter_description"><p>location to place list of items or collections that were unlocked. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Gio.DBusProxy][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place an error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-unlock-sync.returns"></a><h4>Returns</h4>
<p> the number of items or collections that were unlocked</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-store"></a><h3>secret_service_store ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
secret_service_store (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *service</code></em>,
<em class="parameter"><code>const <a class="link" href="libsecret-SecretSchema.html#SecretSchema" title="SecretSchema"><span class="type">SecretSchema</span></a> *schema</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *attributes</code></em>,
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *collection</code></em>,
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
<em class="parameter"><code><a class="link" href="SecretValue.html" title="SecretValue"><span class="type">SecretValue</span></a> *value</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<p>Store a secret value in the secret service.</p>
<p>The <em class="parameter"><code>attributes</code></em>
should be a set of key and value string pairs.</p>
<p>If the attributes match a secret item already stored in the collection, then
the item will be updated with these new values.</p>
<p>If <em class="parameter"><code>service</code></em>
is NULL, then <a class="link" href="SecretService.html#secret-service-get" title="secret_service_get ()"><code class="function">secret_service_get()</code></a> will be called to get
the default <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy.</p>
<p>If <em class="parameter"><code>collection</code></em>
is not specified, then the default collection will be
used. Use <a class="link" href="libsecret-Password-storage.html#SECRET-COLLECTION-SESSION:CAPS" title="SECRET_COLLECTION_SESSION"><span class="type">SECRET_COLLECTION_SESSION</span></a> to store the password in the session
collection, which doesn't get stored across login sessions.</p>
<p>This method will return immediately and complete asynchronously.</p>
<div class="refsect3">
<a name="secret-service-store.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>the secret service. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>schema</p></td>
<td class="parameter_description"><p>the schema to use to check attributes. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>attributes</p></td>
<td class="parameter_description"><p>the attribute keys and values. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 utf8]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>collection</p></td>
<td class="parameter_description"><p>a collection alias, or D-Bus object path of the collection where to store the secret. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>label</p></td>
<td class="parameter_description"><p>label for the secret</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>the secret value</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>called when the operation completes</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>data to be passed to the callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-store-finish"></a><h3>secret_service_store_finish ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
secret_service_store_finish (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *service</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> *result</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Finish asynchronous operation to store a secret value in the secret service.</p>
<div class="refsect3">
<a name="secret-service-store-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>the secret service. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>result</p></td>
<td class="parameter_description"><p>the asynchronous result passed to the callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place an error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-store-finish.returns"></a><h4>Returns</h4>
<p> whether the storage was successful or not</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-store-sync"></a><h3>secret_service_store_sync ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
secret_service_store_sync (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *service</code></em>,
<em class="parameter"><code>const <a class="link" href="libsecret-SecretSchema.html#SecretSchema" title="SecretSchema"><span class="type">SecretSchema</span></a> *schema</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *attributes</code></em>,
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *collection</code></em>,
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
<em class="parameter"><code><a class="link" href="SecretValue.html" title="SecretValue"><span class="type">SecretValue</span></a> *value</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Store a secret value in the secret service.</p>
<p>The <em class="parameter"><code>attributes</code></em>
should be a set of key and value string pairs.</p>
<p>If the attributes match a secret item already stored in the collection, then
the item will be updated with these new values.</p>
<p>If <em class="parameter"><code>collection</code></em>
is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the default collection will be
used. Use <a class="link" href="libsecret-Password-storage.html#SECRET-COLLECTION-SESSION:CAPS" title="SECRET_COLLECTION_SESSION"><span class="type">SECRET_COLLECTION_SESSION</span></a> to store the password in the session
collection, which doesn't get stored across login sessions.</p>
<p>If <em class="parameter"><code>service</code></em>
is NULL, then <a class="link" href="SecretService.html#secret-service-get-sync" title="secret_service_get_sync ()"><code class="function">secret_service_get_sync()</code></a> will be called to get
the default <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy.</p>
<p>This method may block indefinitely and should not be used in user interface
threads.</p>
<div class="refsect3">
<a name="secret-service-store-sync.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>the secret service. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>schema</p></td>
<td class="parameter_description"><p>the schema for the attributes. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>attributes</p></td>
<td class="parameter_description"><p>the attribute keys and values. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 utf8]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>collection</p></td>
<td class="parameter_description"><p>a collection alias, or D-Bus object path of the collection where to store the secret. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>label</p></td>
<td class="parameter_description"><p>label for the secret</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>the secret value</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place an error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-store-sync.returns"></a><h4>Returns</h4>
<p> whether the storage was successful or not</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-lookup"></a><h3>secret_service_lookup ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
secret_service_lookup (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *service</code></em>,
<em class="parameter"><code>const <a class="link" href="libsecret-SecretSchema.html#SecretSchema" title="SecretSchema"><span class="type">SecretSchema</span></a> *schema</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *attributes</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<p>Lookup a secret value in the secret service.</p>
<p>The <em class="parameter"><code>attributes</code></em>
should be a set of key and value string pairs.</p>
<p>If <em class="parameter"><code>service</code></em>
is NULL, then <a class="link" href="SecretService.html#secret-service-get" title="secret_service_get ()"><code class="function">secret_service_get()</code></a> will be called to get
the default <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy.</p>
<p>This method will return immediately and complete asynchronously.</p>
<div class="refsect3">
<a name="secret-service-lookup.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>the secret service. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>schema</p></td>
<td class="parameter_description"><p>the schema for the attributes. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>attributes</p></td>
<td class="parameter_description"><p>the attribute keys and values. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 utf8]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>called when the operation completes</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>data to be passed to the callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-lookup-finish"></a><h3>secret_service_lookup_finish ()</h3>
<pre class="programlisting"><a class="link" href="SecretValue.html" title="SecretValue"><span class="returnvalue">SecretValue</span></a> *
secret_service_lookup_finish (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *service</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> *result</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Finish asynchronous operation to lookup a secret value in the secret service.</p>
<p>If no secret is found then <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned.</p>
<div class="refsect3">
<a name="secret-service-lookup-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>the secret service. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>result</p></td>
<td class="parameter_description"><p>the asynchronous result passed to the callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place an error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-lookup-finish.returns"></a><h4>Returns</h4>
<p>a newly allocated <a class="link" href="SecretValue.html" title="SecretValue"><span class="type">SecretValue</span></a>, which should be
released with <a class="link" href="SecretValue.html#secret-value-unref" title="secret_value_unref ()"><code class="function">secret_value_unref()</code></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no secret found. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-lookup-sync"></a><h3>secret_service_lookup_sync ()</h3>
<pre class="programlisting"><a class="link" href="SecretValue.html" title="SecretValue"><span class="returnvalue">SecretValue</span></a> *
secret_service_lookup_sync (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *service</code></em>,
<em class="parameter"><code>const <a class="link" href="libsecret-SecretSchema.html#SecretSchema" title="SecretSchema"><span class="type">SecretSchema</span></a> *schema</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *attributes</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Lookup a secret value in the secret service.</p>
<p>The <em class="parameter"><code>attributes</code></em>
should be a set of key and value string pairs.</p>
<p>If <em class="parameter"><code>service</code></em>
is NULL, then <a class="link" href="SecretService.html#secret-service-get-sync" title="secret_service_get_sync ()"><code class="function">secret_service_get_sync()</code></a> will be called to get
the default <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy.</p>
<p>This method may block indefinitely and should not be used in user interface
threads.</p>
<div class="refsect3">
<a name="secret-service-lookup-sync.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>the secret service. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>schema</p></td>
<td class="parameter_description"><p>the schema for the attributes. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>attributes</p></td>
<td class="parameter_description"><p>the attribute keys and values. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 utf8]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place an error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-lookup-sync.returns"></a><h4>Returns</h4>
<p>a newly allocated <a class="link" href="SecretValue.html" title="SecretValue"><span class="type">SecretValue</span></a>, which should be
released with <a class="link" href="SecretValue.html#secret-value-unref" title="secret_value_unref ()"><code class="function">secret_value_unref()</code></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no secret found. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-clear"></a><h3>secret_service_clear ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
secret_service_clear (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *service</code></em>,
<em class="parameter"><code>const <a class="link" href="libsecret-SecretSchema.html#SecretSchema" title="SecretSchema"><span class="type">SecretSchema</span></a> *schema</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *attributes</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<p>Remove unlocked items which match the attributes from the secret service.</p>
<p>The <em class="parameter"><code>attributes</code></em>
should be a set of key and value string pairs.</p>
<p>If <em class="parameter"><code>service</code></em>
is NULL, then <a class="link" href="SecretService.html#secret-service-get" title="secret_service_get ()"><code class="function">secret_service_get()</code></a> will be called to get
the default <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy.</p>
<p>This method will return immediately and complete asynchronously.</p>
<div class="refsect3">
<a name="secret-service-clear.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>the secret service. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>schema</p></td>
<td class="parameter_description"><p>the schema for the attributes. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>attributes</p></td>
<td class="parameter_description"><p>the attribute keys and values. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 utf8]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>called when the operation completes</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>data to be passed to the callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-clear-finish"></a><h3>secret_service_clear_finish ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
secret_service_clear_finish (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *service</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> *result</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Finish asynchronous operation to remove items from the secret
service.</p>
<div class="refsect3">
<a name="secret-service-clear-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>the secret service. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>result</p></td>
<td class="parameter_description"><p>the asynchronous result passed to the callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place an error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-clear-finish.returns"></a><h4>Returns</h4>
<p> whether items were removed or not</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-clear-sync"></a><h3>secret_service_clear_sync ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
secret_service_clear_sync (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *service</code></em>,
<em class="parameter"><code>const <a class="link" href="libsecret-SecretSchema.html#SecretSchema" title="SecretSchema"><span class="type">SecretSchema</span></a> *schema</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *attributes</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Remove unlocked items which match the attributes from the secret service.</p>
<p>The <em class="parameter"><code>attributes</code></em>
should be a set of key and value string pairs.</p>
<p>If <em class="parameter"><code>service</code></em>
is NULL, then <a class="link" href="SecretService.html#secret-service-get-sync" title="secret_service_get_sync ()"><code class="function">secret_service_get_sync()</code></a> will be called to get
the default <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy.</p>
<p>This method may block indefinitely and should not be used in user interface
threads.</p>
<div class="refsect3">
<a name="secret-service-clear-sync.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>the secret service. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>schema</p></td>
<td class="parameter_description"><p>the schema for the attributes. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>attributes</p></td>
<td class="parameter_description"><p>the attribute keys and values. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 utf8]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place an error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-clear-sync.returns"></a><h4>Returns</h4>
<p> whether items were removed or not</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-prompt"></a><h3>secret_service_prompt ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
secret_service_prompt (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="SecretPrompt.html" title="SecretPrompt"><span class="type">SecretPrompt</span></a> *prompt</code></em>,
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-GVariantType.html#GVariantType"><span class="type">GVariantType</span></a> *return_type</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<p>Perform prompting for a <a class="link" href="SecretPrompt.html" title="SecretPrompt"><span class="type">SecretPrompt</span></a>.</p>
<p>This function is called by other parts of this library to handle prompts
for the various actions that can require prompting.</p>
<p>Override the <a class="link" href="SecretService.html#SecretServiceClass" title="struct SecretServiceClass"><span class="type">SecretServiceClass</span></a> <code class="literal">prompt_async</code> virtual method
to change the behavior of the prompting. The default behavior is to simply
run <a class="link" href="SecretPrompt.html#secret-prompt-perform" title="secret_prompt_perform ()"><code class="function">secret_prompt_perform()</code></a> on the prompt.</p>
<div class="refsect3">
<a name="secret-service-prompt.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>the secret service</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>prompt</p></td>
<td class="parameter_description"><p>the prompt</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>return_type</p></td>
<td class="parameter_description"><p>the variant type of the prompt result. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>called when the operation completes</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>data to be passed to the callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-prompt-finish"></a><h3>secret_service_prompt_finish ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
secret_service_prompt_finish (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *self</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> *result</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Complete asynchronous operation to perform prompting for a <a class="link" href="SecretPrompt.html" title="SecretPrompt"><span class="type">SecretPrompt</span></a>.</p>
<p>Returns a variant result if the prompt was completed and not dismissed. The
type of result depends on the action the prompt is completing, and is defined
in the Secret Service DBus API specification.</p>
<div class="refsect3">
<a name="secret-service-prompt-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>the secret service</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>result</p></td>
<td class="parameter_description"><p>the asynchronous result passed to the callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place an error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-prompt-finish.returns"></a><h4>Returns</h4>
<p><a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the prompt was dismissed or an error occurred,
a variant result if the prompt was successful. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-prompt-sync"></a><h3>secret_service_prompt_sync ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
secret_service_prompt_sync (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="SecretPrompt.html" title="SecretPrompt"><span class="type">SecretPrompt</span></a> *prompt</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-GVariantType.html#GVariantType"><span class="type">GVariantType</span></a> *return_type</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Perform prompting for a <a class="link" href="SecretPrompt.html" title="SecretPrompt"><span class="type">SecretPrompt</span></a>.</p>
<p>Runs a prompt and performs the prompting. Returns a variant result if the
prompt was completed and not dismissed. The type of result depends on the
action the prompt is completing, and is defined in the Secret Service DBus
API specification.</p>
<p>This function is called by other parts of this library to handle prompts
for the various actions that can require prompting.</p>
<p>Override the <a class="link" href="SecretService.html#SecretServiceClass" title="struct SecretServiceClass"><span class="type">SecretServiceClass</span></a> <code class="literal">prompt_sync</code> virtual method
to change the behavior of the prompting. The default behavior is to simply
run <a class="link" href="SecretPrompt.html#secret-prompt-perform-sync" title="secret_prompt_perform_sync ()"><code class="function">secret_prompt_perform_sync()</code></a> on the prompt with a <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> <code class="literal">window_id</code>.</p>
<div class="refsect3">
<a name="secret-service-prompt-sync.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>the secret service</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>prompt</p></td>
<td class="parameter_description"><p>the prompt</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>return_type</p></td>
<td class="parameter_description"><p>the variant type of the prompt result</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place an error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-prompt-sync.returns"></a><h4>Returns</h4>
<p><a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the prompt was dismissed or an error occurred,
a variant result if the prompt was successful. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-set-alias"></a><h3>secret_service_set_alias ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
secret_service_set_alias (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *service</code></em>,
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *alias</code></em>,
<em class="parameter"><code><a class="link" href="SecretCollection.html" title="SecretCollection"><span class="type">SecretCollection</span></a> *collection</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<p>Assign a collection to this alias. Aliases help determine
well known collections, such as 'default'.</p>
<p>If <em class="parameter"><code>service</code></em>
is NULL, then <a class="link" href="SecretService.html#secret-service-get" title="secret_service_get ()"><code class="function">secret_service_get()</code></a> will be called to get
the default <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy.</p>
<p>This method will return immediately and complete asynchronously.</p>
<div class="refsect3">
<a name="secret-service-set-alias.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>a secret service object. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>alias</p></td>
<td class="parameter_description"><p>the alias to assign the collection to</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>collection</p></td>
<td class="parameter_description"><p>the collection to assign to the alias. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>called when the operation completes</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>data to pass to the callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-set-alias-finish"></a><h3>secret_service_set_alias_finish ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
secret_service_set_alias_finish (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *service</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> *result</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Finish an asynchronous operation to assign a collection to an alias.</p>
<div class="refsect3">
<a name="secret-service-set-alias-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>a secret service object. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>result</p></td>
<td class="parameter_description"><p>asynchronous result passed to callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-set-alias-finish.returns"></a><h4>Returns</h4>
<p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if successful</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-set-alias-sync"></a><h3>secret_service_set_alias_sync ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
secret_service_set_alias_sync (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *service</code></em>,
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *alias</code></em>,
<em class="parameter"><code><a class="link" href="SecretCollection.html" title="SecretCollection"><span class="type">SecretCollection</span></a> *collection</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Assign a collection to this alias. Aliases help determine
well known collections, such as 'default'.</p>
<p>If <em class="parameter"><code>service</code></em>
is NULL, then <a class="link" href="SecretService.html#secret-service-get-sync" title="secret_service_get_sync ()"><code class="function">secret_service_get_sync()</code></a> will be called to get
the default <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy.</p>
<p>This method may block and should not be used in user interface threads.</p>
<div class="refsect3">
<a name="secret-service-set-alias-sync.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>a secret service object. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>alias</p></td>
<td class="parameter_description"><p>the alias to assign the collection to</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>collection</p></td>
<td class="parameter_description"><p>the collection to assign to the alias. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to place error on failure</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-set-alias-sync.returns"></a><h4>Returns</h4>
<p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if successful</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-get-collection-gtype"></a><h3>secret_service_get_collection_gtype ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>
secret_service_get_collection_gtype (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *self</code></em>);</pre>
<p>Get the GObject type for collections instantiated by this service.
This will always be either <a class="link" href="SecretCollection.html" title="SecretCollection"><span class="type">SecretCollection</span></a> or derived from it.</p>
<div class="refsect3">
<a name="secret-service-get-collection-gtype.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>the secret service</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-get-collection-gtype.returns"></a><h4>Returns</h4>
<p> the gobject type for collections</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="secret-service-get-item-gtype"></a><h3>secret_service_get_item_gtype ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>
secret_service_get_item_gtype (<em class="parameter"><code><a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> *self</code></em>);</pre>
<p>Get the GObject type for items instantiated by this service.
This will always be either <a class="link" href="SecretItem.html" title="SecretItem"><span class="type">SecretItem</span></a> or derived from it.</p>
<div class="refsect3">
<a name="secret-service-get-item-gtype.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>the service</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="secret-service-get-item-gtype.returns"></a><h4>Returns</h4>
<p> the gobject type for items</p>
</div>
</div>
</div>
<div class="refsect1">
<a name="SecretService.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="SecretService-struct"></a><h3>struct SecretService</h3>
<pre class="programlisting">struct SecretService;</pre>
<p>A proxy object representing the Secret Service.</p>
</div>
<hr>
<div class="refsect2">
<a name="SecretServiceClass"></a><h3>struct SecretServiceClass</h3>
<pre class="programlisting">struct SecretServiceClass {
GDBusProxyClass parent_class;
GType collection_gtype;
GType item_gtype;
GVariant * (* prompt_sync) (SecretService *self,
SecretPrompt *prompt,
GCancellable *cancellable,
const GVariantType *return_type,
GError **error);
void (* prompt_async) (SecretService *self,
SecretPrompt *prompt,
const GVariantType *return_type,
GCancellable *cancellable,
GAsyncReadyCallback callback,
gpointer user_data);
GVariant * (* prompt_finish) (SecretService *self,
GAsyncResult *result,
GError **error);
GType (* get_collection_gtype) (SecretService *self);
GType (* get_item_gtype) (SecretService *self);
};
</pre>
<p>The class for <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a>.</p>
<div class="refsect3">
<a name="SecretServiceClass.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="struct_member_name"><p><a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> <em class="structfield"><code><a name="SecretServiceClass.collection-gtype"></a>collection_gtype</code></em>;</p></td>
<td class="struct_member_description"><p>the <a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of the <a class="link" href="SecretCollection.html" title="SecretCollection"><span class="type">SecretCollection</span></a> objects instantiated
by the <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> <em class="structfield"><code><a name="SecretServiceClass.item-gtype"></a>item_gtype</code></em>;</p></td>
<td class="struct_member_description"><p>the <a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of the <a class="link" href="SecretItem.html" title="SecretItem"><span class="type">SecretItem</span></a> objects instantiated by the
<a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="SecretServiceClass.prompt-sync"></a>prompt_sync</code></em> ()</p></td>
<td class="struct_member_description"><p>called to perform synchronous prompting when necessary</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="SecretServiceClass.prompt-async"></a>prompt_async</code></em> ()</p></td>
<td class="struct_member_description"><p>called to perform asynchronous prompting when necessary</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="SecretServiceClass.prompt-finish"></a>prompt_finish</code></em> ()</p></td>
<td class="struct_member_description"><p>called to complete an asynchronous prompt operation</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="SecretServiceClass.get-collection-gtype"></a>get_collection_gtype</code></em> ()</p></td>
<td class="struct_member_description"><p>called to get the GObject type for collections
instantiated by the <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="SecretServiceClass.get-item-gtype"></a>get_item_gtype</code></em> ()</p></td>
<td class="struct_member_description"><p>called to get the GObject type for collections
instantiated by the <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy</p></td>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="SecretServiceFlags"></a><h3>enum SecretServiceFlags</h3>
<p>Flags which determine which parts of the <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a> proxy are initialized
during a <a class="link" href="SecretService.html#secret-service-get" title="secret_service_get ()"><code class="function">secret_service_get()</code></a> or <a class="link" href="SecretService.html#secret-service-open" title="secret_service_open ()"><code class="function">secret_service_open()</code></a> operation.</p>
<div class="refsect3">
<a name="SecretServiceFlags.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="SECRET-SERVICE-NONE:CAPS"></a>SECRET_SERVICE_NONE</p></td>
<td class="enum_member_description">
<p>no flags for initializing the <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a></p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="SECRET-SERVICE-OPEN-SESSION:CAPS"></a>SECRET_SERVICE_OPEN_SESSION</p></td>
<td class="enum_member_description">
<p>establish a session for transfer of secrets
while initializing the <a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a></p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="SECRET-SERVICE-LOAD-COLLECTIONS:CAPS"></a>SECRET_SERVICE_LOAD_COLLECTIONS</p></td>
<td class="enum_member_description">
<p>load collections while initializing the
<a class="link" href="SecretService.html" title="SecretService"><span class="type">SecretService</span></a></p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="SecretSearchFlags"></a><h3>enum SecretSearchFlags</h3>
<p>Various flags to be used with <a class="link" href="SecretService.html#secret-service-search" title="secret_service_search ()"><code class="function">secret_service_search()</code></a> and <a class="link" href="SecretService.html#secret-service-search-sync" title="secret_service_search_sync ()"><code class="function">secret_service_search_sync()</code></a>.</p>
<div class="refsect3">
<a name="SecretSearchFlags.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="SECRET-SEARCH-NONE:CAPS"></a>SECRET_SEARCH_NONE</p></td>
<td class="enum_member_description">
<p>no flags</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="SECRET-SEARCH-ALL:CAPS"></a>SECRET_SEARCH_ALL</p></td>
<td class="enum_member_description">
<p>all the items matching the search will be returned, instead of just the first one</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="SECRET-SEARCH-UNLOCK:CAPS"></a>SECRET_SEARCH_UNLOCK</p></td>
<td class="enum_member_description">
<p>unlock locked items while searching</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="SECRET-SEARCH-LOAD-SECRETS:CAPS"></a>SECRET_SEARCH_LOAD_SECRETS</p></td>
<td class="enum_member_description">
<p>while searching load secrets for items that are not locked</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="refsect1">
<a name="SecretService.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="SecretService--collections"></a><h3>The <code class="literal">“collections”</code> property</h3>
<pre class="programlisting"> “collections” <span class="type">SecretObjectList</span> *</pre>
<p>A list of <a class="link" href="SecretCollection.html" title="SecretCollection"><span class="type">SecretCollection</span></a> objects representing the collections in
the Secret Service. This list may be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the collections have
not been loaded.</p>
<p>To load the collections, specify the <a class="link" href="SecretService.html#SECRET-SERVICE-LOAD-COLLECTIONS:CAPS"><code class="literal">SECRET_SERVICE_LOAD_COLLECTIONS</code></a>
initialization flag when calling the <a class="link" href="SecretService.html#secret-service-get" title="secret_service_get ()"><code class="function">secret_service_get()</code></a> or
<a class="link" href="SecretService.html#secret-service-open" title="secret_service_open ()"><code class="function">secret_service_open()</code></a> functions. Or call the <a class="link" href="SecretService.html#secret-service-load-collections" title="secret_service_load_collections ()"><code class="function">secret_service_load_collections()</code></a>
method.</p>
<p>Owner: SecretService</p>
<p>Flags: Read</p>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.32</div>
</body>
</html>