| Current File : //proc/thread-self/root/kunden/usr/share/gtk-doc/html/polkit-1/PolkitAuthority.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>PolkitAuthority: polkit Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="polkit Reference Manual">
<link rel="up" href="ref-api.html" title="Part III. Library API Reference">
<link rel="prev" href="ref-api.html" title="Part III. Library API Reference">
<link rel="next" href="PolkitAuthorizationResult.html" title="PolkitAuthorizationResult">
<meta name="generator" content="GTK-Doc V1.33.1 (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="#PolkitAuthority.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
<a href="#PolkitAuthority.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces"> <span class="dim">|</span>
<a href="#PolkitAuthority.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties"> <span class="dim">|</span>
<a href="#PolkitAuthority.properties" class="shortcut">Properties</a></span><span id="nav_signals"> <span class="dim">|</span>
<a href="#PolkitAuthority.signals" class="shortcut">Signals</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="ref-api.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="ref-api.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="PolkitAuthorizationResult.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="PolkitAuthority"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="PolkitAuthority.top_of_page"></a>PolkitAuthority</span></h2>
<p>PolkitAuthority — Authority</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="PolkitAuthority.stability-level"></a><h2>Stability Level</h2>
<acronym title="The intention of a Stable interface is to enable arbitrary third parties to
develop applications to these interfaces, release them, and have confidence that
they will run on all minor releases of the product (after the one in which the
interface was introduced, and within the same major release). Even at a major
release, incompatible changes are expected to be rare, and to have strong
justifications.
"><span class="acronym">Stable</span></acronym>, unless otherwise indicated
</div>
<div class="refsect1">
<a name="PolkitAuthority.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="PolkitAuthority.html#polkit-authority-get-async" title="polkit_authority_get_async ()">polkit_authority_get_async</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="returnvalue">PolkitAuthority</span></a> *
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-get-finish" title="polkit_authority_get_finish ()">polkit_authority_get_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="returnvalue">PolkitAuthority</span></a> *
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-get-sync" title="polkit_authority_get_sync ()">polkit_authority_get_sync</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="returnvalue">PolkitAuthority</span></a> *
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-get" title="polkit_authority_get ()">polkit_authority_get</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-get-owner" title="polkit_authority_get_owner ()">polkit_authority_get_owner</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-get-backend-name" title="polkit_authority_get_backend_name ()">polkit_authority_get_backend_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-get-backend-version" title="polkit_authority_get_backend_version ()">polkit_authority_get_backend_version</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="PolkitAuthority.html#PolkitAuthorityFeatures" title="enum PolkitAuthorityFeatures"><span class="returnvalue">PolkitAuthorityFeatures</span></a>
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-get-backend-features" title="polkit_authority_get_backend_features ()">polkit_authority_get_backend_features</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="PolkitAuthority.html#polkit-authority-check-authorization" title="polkit_authority_check_authorization ()">polkit_authority_check_authorization</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="PolkitAuthorizationResult.html" title="PolkitAuthorizationResult"><span class="returnvalue">PolkitAuthorizationResult</span></a> *
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-check-authorization-finish" title="polkit_authority_check_authorization_finish ()">polkit_authority_check_authorization_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="PolkitAuthorizationResult.html" title="PolkitAuthorizationResult"><span class="returnvalue">PolkitAuthorizationResult</span></a> *
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-check-authorization-sync" title="polkit_authority_check_authorization_sync ()">polkit_authority_check_authorization_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="PolkitAuthority.html#polkit-authority-enumerate-actions" title="polkit_authority_enumerate_actions ()">polkit_authority_enumerate_actions</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GList</span> *
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-enumerate-actions-finish" title="polkit_authority_enumerate_actions_finish ()">polkit_authority_enumerate_actions_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GList</span> *
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-enumerate-actions-sync" title="polkit_authority_enumerate_actions_sync ()">polkit_authority_enumerate_actions_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="PolkitAuthority.html#polkit-authority-register-authentication-agent" title="polkit_authority_register_authentication_agent ()">polkit_authority_register_authentication_agent</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-register-authentication-agent-finish" title="polkit_authority_register_authentication_agent_finish ()">polkit_authority_register_authentication_agent_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-register-authentication-agent-sync" title="polkit_authority_register_authentication_agent_sync ()">polkit_authority_register_authentication_agent_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="PolkitAuthority.html#polkit-authority-register-authentication-agent-with-options" title="polkit_authority_register_authentication_agent_with_options ()">polkit_authority_register_authentication_agent_with_options</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-register-authentication-agent-with-options-finish" title="polkit_authority_register_authentication_agent_with_options_finish ()">polkit_authority_register_authentication_agent_with_options_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-register-authentication-agent-with-options-sync" title="polkit_authority_register_authentication_agent_with_options_sync ()">polkit_authority_register_authentication_agent_with_options_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="PolkitAuthority.html#polkit-authority-unregister-authentication-agent" title="polkit_authority_unregister_authentication_agent ()">polkit_authority_unregister_authentication_agent</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-unregister-authentication-agent-finish" title="polkit_authority_unregister_authentication_agent_finish ()">polkit_authority_unregister_authentication_agent_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-unregister-authentication-agent-sync" title="polkit_authority_unregister_authentication_agent_sync ()">polkit_authority_unregister_authentication_agent_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="PolkitAuthority.html#polkit-authority-authentication-agent-response" title="polkit_authority_authentication_agent_response ()">polkit_authority_authentication_agent_response</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-authentication-agent-response-finish" title="polkit_authority_authentication_agent_response_finish ()">polkit_authority_authentication_agent_response_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-authentication-agent-response-sync" title="polkit_authority_authentication_agent_response_sync ()">polkit_authority_authentication_agent_response_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="PolkitAuthority.html#polkit-authority-enumerate-temporary-authorizations" title="polkit_authority_enumerate_temporary_authorizations ()">polkit_authority_enumerate_temporary_authorizations</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GList</span> *
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-enumerate-temporary-authorizations-finish" title="polkit_authority_enumerate_temporary_authorizations_finish ()">polkit_authority_enumerate_temporary_authorizations_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GList</span> *
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-enumerate-temporary-authorizations-sync" title="polkit_authority_enumerate_temporary_authorizations_sync ()">polkit_authority_enumerate_temporary_authorizations_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="PolkitAuthority.html#polkit-authority-revoke-temporary-authorizations" title="polkit_authority_revoke_temporary_authorizations ()">polkit_authority_revoke_temporary_authorizations</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-revoke-temporary-authorizations-finish" title="polkit_authority_revoke_temporary_authorizations_finish ()">polkit_authority_revoke_temporary_authorizations_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-revoke-temporary-authorizations-sync" title="polkit_authority_revoke_temporary_authorizations_sync ()">polkit_authority_revoke_temporary_authorizations_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="PolkitAuthority.html#polkit-authority-revoke-temporary-authorization-by-id" title="polkit_authority_revoke_temporary_authorization_by_id ()">polkit_authority_revoke_temporary_authorization_by_id</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-revoke-temporary-authorization-by-id-finish" title="polkit_authority_revoke_temporary_authorization_by_id_finish ()">polkit_authority_revoke_temporary_authorization_by_id_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="PolkitAuthority.html#polkit-authority-revoke-temporary-authorization-by-id-sync" title="polkit_authority_revoke_temporary_authorization_by_id_sync ()">polkit_authority_revoke_temporary_authorization_by_id_sync</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="PolkitAuthority.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"><a class="link" href="PolkitAuthority.html#PolkitAuthorityFeatures" title="enum PolkitAuthorityFeatures"><span class="type">PolkitAuthorityFeatures</span></a></td>
<td class="property_name"><a class="link" href="PolkitAuthority.html#PolkitAuthority--backend-features" title="The “backend-features” property">backend-features</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="PolkitAuthority.html#PolkitAuthority--backend-name" title="The “backend-name” property">backend-name</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="PolkitAuthority.html#PolkitAuthority--backend-version" title="The “backend-version” property">backend-version</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="PolkitAuthority.html#PolkitAuthority--owner" title="The “owner” property">owner</a></td>
<td class="property_flags">Read</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="PolkitAuthority.signals"></a><h2>Signals</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="signal_proto_type">
<col width="300px" class="signal_proto_name">
<col width="200px" class="signal_proto_flags">
</colgroup>
<tbody>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="PolkitAuthority.html#PolkitAuthority-changed" title="The “changed” signal">changed</a></td>
<td class="signal_flags">Run Last</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="PolkitAuthority.html#PolkitAuthority-sessions-changed" title="The “sessions-changed” signal">sessions-changed</a></td>
<td class="signal_flags">Run Last</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="PolkitAuthority.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"> </td>
<td class="function_name"><a class="link" href="PolkitAuthority.html#PolkitAuthority-struct" title="PolkitAuthority">PolkitAuthority</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="PolkitAuthority.html#PolkitAuthorityFeatures" title="enum PolkitAuthorityFeatures">PolkitAuthorityFeatures</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="PolkitAuthority.html#PolkitCheckAuthorizationFlags" title="enum PolkitCheckAuthorizationFlags">PolkitCheckAuthorizationFlags</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="PolkitAuthority.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> PolkitAuthorityFeatures
<span class="lineart">╰──</span> PolkitCheckAuthorizationFlags
GObject
<span class="lineart">╰──</span> PolkitAuthority
</pre>
</div>
<div class="refsect1">
<a name="PolkitAuthority.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
PolkitAuthority implements
GInitable and GAsyncInitable.</p>
</div>
<div class="refsect1">
<a name="PolkitAuthority.description"></a><h2>Description</h2>
<p><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> is used for checking whether a given subject is
authorized to perform a given action. Typically privileged system
daemons or suid helpers will use this when handling requests from
untrusted clients.</p>
<p>User sessions can register an authentication agent with the
authority. This is used for requests from untrusted clients where
system policy requires that the user needs to acknowledge (through
proving he is the user or the administrator) a given action. See
<a class="link" href="PolkitAgentListener.html" title="PolkitAgentListener"><span class="type">PolkitAgentListener</span></a> and <a class="link" href="PolkitAgentSession.html" title="PolkitAgentSession"><span class="type">PolkitAgentSession</span></a> for details.</p>
</div>
<div class="refsect1">
<a name="PolkitAuthority.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="polkit-authority-get-async"></a><h3>polkit_authority_get_async ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
polkit_authority_get_async (<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
<p>Asynchronously gets a reference to the authority.</p>
<p>This is an asynchronous failable function. When the result is
ready, <em class="parameter"><code>callback</code></em>
will be invoked in the <GTKDOCLINK HREF="g-main-context-push-thread-default">thread-default main
loop</GTKDOCLINK> of the thread you are calling this method from and you
can use <a class="link" href="PolkitAuthority.html#polkit-authority-get-finish" title="polkit_authority_get_finish ()"><code class="function">polkit_authority_get_finish()</code></a> to get the result. See
<a class="link" href="PolkitAuthority.html#polkit-authority-get-sync" title="polkit_authority_get_sync ()"><code class="function">polkit_authority_get_sync()</code></a> for the synchronous version.</p>
<div class="refsect3">
<a name="polkit-authority-get-async.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>cancellable</p></td>
<td class="parameter_description"><p>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </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>A <span class="type">GAsyncReadyCallback</span> to call when the request is satisfied.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>The data to pass to <em class="parameter"><code>callback</code></em>
.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-get-finish"></a><h3>polkit_authority_get_finish ()</h3>
<pre class="programlisting"><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="returnvalue">PolkitAuthority</span></a> *
polkit_authority_get_finish (<em class="parameter"><code><span class="type">GAsyncResult</span> *res</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Finishes an operation started with <a class="link" href="PolkitAuthority.html#polkit-authority-get-async" title="polkit_authority_get_async ()"><code class="function">polkit_authority_get_async()</code></a>.</p>
<div class="refsect3">
<a name="polkit-authority-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>res</p></td>
<td class="parameter_description"><p>A <span class="type">GAsyncResult</span> obtained from the <span class="type">GAsyncReadyCallback</span> passed to <a class="link" href="PolkitAuthority.html#polkit-authority-get-async" title="polkit_authority_get_async ()"><code class="function">polkit_authority_get_async()</code></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>Return location for error or <code class="literal">NULL</code>. </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>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-get-finish.returns"></a><h4>Returns</h4>
<p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>. Free it with
<code class="function">g_object_unref()</code> when done with it. </p>
<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-get-sync"></a><h3>polkit_authority_get_sync ()</h3>
<pre class="programlisting"><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="returnvalue">PolkitAuthority</span></a> *
polkit_authority_get_sync (<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Synchronously gets a reference to the authority.</p>
<p>This is a synchronous failable function - the calling thread is
blocked until a reply is received. See <a class="link" href="PolkitAuthority.html#polkit-authority-get-async" title="polkit_authority_get_async ()"><code class="function">polkit_authority_get_async()</code></a>
for the asynchronous version.</p>
<div class="refsect3">
<a name="polkit-authority-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>cancellable</p></td>
<td class="parameter_description"><p>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </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>Return location for error or <code class="literal">NULL</code>. </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>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-get-sync.returns"></a><h4>Returns</h4>
<p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>. Free it with
<code class="function">g_object_unref()</code> when done with it. </p>
<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-get"></a><h3>polkit_authority_get ()</h3>
<pre class="programlisting"><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="returnvalue">PolkitAuthority</span></a> *
polkit_authority_get (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<div class="warning"><p><code class="literal">polkit_authority_get</code> is deprecated and should not be used in newly-written code.</p></div>
<p>(deprecated)</p>
<div class="refsect3">
<a name="polkit-authority-get.returns"></a><h4>Returns</h4>
<p>value. </p>
<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-get-owner"></a><h3>polkit_authority_get_owner ()</h3>
<pre class="programlisting"><span class="returnvalue">gchar</span> *
polkit_authority_get_owner (<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>);</pre>
<p>The unique name on the system message bus of the owner of the name
<code class="literal">org.freedesktop.PolicyKit1</code> or <code class="literal">NULL</code> if no-one
currently owns the name. You may connect to the <span class="type">“notify”</span>
signal to track changes to the <a class="link" href="PolkitAuthority.html#PolkitAuthority--owner" title="The “owner” property"><span class="type">“owner”</span></a> property.</p>
<div class="refsect3">
<a name="polkit-authority-get-owner.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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-get-owner.returns"></a><h4>Returns</h4>
<p><code class="literal">NULL</code> or a string that should be freed with <code class="function">g_free()</code>. </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="polkit-authority-get-backend-name"></a><h3>polkit_authority_get_backend_name ()</h3>
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
polkit_authority_get_backend_name (<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>);</pre>
<p>Gets the name of the authority backend.</p>
<div class="refsect3">
<a name="polkit-authority-get-backend-name.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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-get-backend-name.returns"></a><h4>Returns</h4>
<p> The name of the backend.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-get-backend-version"></a><h3>polkit_authority_get_backend_version ()</h3>
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
polkit_authority_get_backend_version (<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>);</pre>
<p>Gets the version of the authority backend.</p>
<div class="refsect3">
<a name="polkit-authority-get-backend-version.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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-get-backend-version.returns"></a><h4>Returns</h4>
<p> The version string for the backend.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-get-backend-features"></a><h3>polkit_authority_get_backend_features ()</h3>
<pre class="programlisting"><a class="link" href="PolkitAuthority.html#PolkitAuthorityFeatures" title="enum PolkitAuthorityFeatures"><span class="returnvalue">PolkitAuthorityFeatures</span></a>
polkit_authority_get_backend_features (<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>);</pre>
<p>Gets the features supported by the authority backend.</p>
<div class="refsect3">
<a name="polkit-authority-get-backend-features.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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-get-backend-features.returns"></a><h4>Returns</h4>
<p> Flags from <a class="link" href="PolkitAuthority.html#PolkitAuthorityFeatures" title="enum PolkitAuthorityFeatures"><span class="type">PolkitAuthorityFeatures</span></a>.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-check-authorization"></a><h3>polkit_authority_check_authorization ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
polkit_authority_check_authorization (<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><a class="link" href="PolkitSubject.html" title="PolkitSubject"><span class="type">PolkitSubject</span></a> *subject</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *action_id</code></em>,
<em class="parameter"><code><a class="link" href="PolkitDetails.html" title="PolkitDetails"><span class="type">PolkitDetails</span></a> *details</code></em>,
<em class="parameter"><code><a class="link" href="PolkitAuthority.html#PolkitCheckAuthorizationFlags" title="enum PolkitCheckAuthorizationFlags"><span class="type">PolkitCheckAuthorizationFlags</span></a> flags</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
<p>Asynchronously checks if <em class="parameter"><code>subject</code></em>
is authorized to perform the action represented
by <em class="parameter"><code>action_id</code></em>
.</p>
<p>Note that <a class="link" href="PolkitAuthority.html#POLKIT-CHECK-AUTHORIZATION-FLAGS-ALLOW-USER-INTERACTION:CAPS"><code class="literal">POLKIT_CHECK_AUTHORIZATION_FLAGS_ALLOW_USER_INTERACTION</code></a>
<span class="emphasis"><em>SHOULD</em></span> be passed <span class="emphasis"><em>ONLY</em></span> if
the event that triggered the authorization check is stemming from
an user action, e.g. the user pressing a button or attaching a
device.</p>
<p>When the operation is finished, <em class="parameter"><code>callback</code></em>
will be invoked in the</p>
<GTKDOCLINK HREF="g-main-context-push-thread-default">thread-default
main loop</GTKDOCLINK> of the thread you are calling this method
<p>from. You can then call
<a class="link" href="PolkitAuthority.html#polkit-authority-check-authorization-finish" title="polkit_authority_check_authorization_finish ()"><code class="function">polkit_authority_check_authorization_finish()</code></a> to get the result of
the operation.</p>
<p>Known keys in <em class="parameter"><code>details</code></em>
include <code class="literal">polkit.message</code>
and <code class="literal">polkit.gettext_domain</code> that can be used to
override the message shown to the user. See the documentation for
the <a class="link" href="eggdbus-interface-org.freedesktop.PolicyKit1.Authority.html#eggdbus-method-org.freedesktop.PolicyKit1.Authority.CheckAuthorization" title="CheckAuthorization ()">D-Bus method</a> for more details.</p>
<p>If <em class="parameter"><code>details</code></em>
is non-empty then the request will fail with
<a class="link" href="polkit-1-PolkitError.html#POLKIT-ERROR-FAILED:CAPS"><span class="type">POLKIT_ERROR_FAILED</span></a> unless the process doing the check itsef is
sufficiently authorized (e.g. running as uid 0).</p>
<div class="refsect3">
<a name="polkit-authority-check-authorization.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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>subject</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitSubject.html" title="PolkitSubject"><span class="type">PolkitSubject</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>action_id</p></td>
<td class="parameter_description"><p>The action to check for.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>details</p></td>
<td class="parameter_description"><p>Details about the action or <code class="literal">NULL</code>. </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>A set of <a class="link" href="PolkitAuthority.html#PolkitCheckAuthorizationFlags" title="enum PolkitCheckAuthorizationFlags"><span class="type">PolkitCheckAuthorizationFlags</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </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>A <span class="type">GAsyncReadyCallback</span> to call when the request is satisfied.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>The data to pass to <em class="parameter"><code>callback</code></em>
.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-check-authorization-finish"></a><h3>polkit_authority_check_authorization_finish ()</h3>
<pre class="programlisting"><a class="link" href="PolkitAuthorizationResult.html" title="PolkitAuthorizationResult"><span class="returnvalue">PolkitAuthorizationResult</span></a> *
polkit_authority_check_authorization_finish
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><span class="type">GAsyncResult</span> *res</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Finishes checking if a subject is authorized for an action.</p>
<div class="refsect3">
<a name="polkit-authority-check-authorization-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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>res</p></td>
<td class="parameter_description"><p>A <span class="type">GAsyncResult</span> obtained from the callback.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>Return location for error or <code class="literal">NULL</code>. </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>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-check-authorization-finish.returns"></a><h4>Returns</h4>
<p>A <a class="link" href="PolkitAuthorizationResult.html" title="PolkitAuthorizationResult"><span class="type">PolkitAuthorizationResult</span></a> or <code class="literal">NULL</code> if
<em class="parameter"><code>error</code></em>
is set. Free with <code class="function">g_object_unref()</code>. </p>
<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-check-authorization-sync"></a><h3>polkit_authority_check_authorization_sync ()</h3>
<pre class="programlisting"><a class="link" href="PolkitAuthorizationResult.html" title="PolkitAuthorizationResult"><span class="returnvalue">PolkitAuthorizationResult</span></a> *
polkit_authority_check_authorization_sync
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><a class="link" href="PolkitSubject.html" title="PolkitSubject"><span class="type">PolkitSubject</span></a> *subject</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *action_id</code></em>,
<em class="parameter"><code><a class="link" href="PolkitDetails.html" title="PolkitDetails"><span class="type">PolkitDetails</span></a> *details</code></em>,
<em class="parameter"><code><a class="link" href="PolkitAuthority.html#PolkitCheckAuthorizationFlags" title="enum PolkitCheckAuthorizationFlags"><span class="type">PolkitCheckAuthorizationFlags</span></a> flags</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Checks if <em class="parameter"><code>subject</code></em>
is authorized to perform the action represented
by <em class="parameter"><code>action_id</code></em>
.</p>
<p>Note that <a class="link" href="PolkitAuthority.html#POLKIT-CHECK-AUTHORIZATION-FLAGS-ALLOW-USER-INTERACTION:CAPS"><code class="literal">POLKIT_CHECK_AUTHORIZATION_FLAGS_ALLOW_USER_INTERACTION</code></a>
<span class="emphasis"><em>SHOULD</em></span> be passed <span class="emphasis"><em>ONLY</em></span> if
the event that triggered the authorization check is stemming from
an user action, e.g. the user pressing a button or attaching a
device.</p>
<p>Note the calling thread is blocked until a reply is received. You
should therefore <span class="emphasis"><em>NEVER</em></span> do this from a GUI
thread or a daemon service thread when using the
<a class="link" href="PolkitAuthority.html#POLKIT-CHECK-AUTHORIZATION-FLAGS-ALLOW-USER-INTERACTION:CAPS"><code class="literal">POLKIT_CHECK_AUTHORIZATION_FLAGS_ALLOW_USER_INTERACTION</code></a> flag. This
is because it may potentially take minutes (or even hours) for the
operation to complete because it involves waiting for the user to
authenticate.</p>
<p>Known keys in <em class="parameter"><code>details</code></em>
include <code class="literal">polkit.message</code>
and <code class="literal">polkit.gettext_domain</code> that can be used to
override the message shown to the user. See the documentation for
the <a class="link" href="eggdbus-interface-org.freedesktop.PolicyKit1.Authority.html#eggdbus-method-org.freedesktop.PolicyKit1.Authority.CheckAuthorization" title="CheckAuthorization ()">D-Bus method</a> for more details.</p>
<div class="refsect3">
<a name="polkit-authority-check-authorization-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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>subject</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitSubject.html" title="PolkitSubject"><span class="type">PolkitSubject</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>action_id</p></td>
<td class="parameter_description"><p>The action to check for.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>details</p></td>
<td class="parameter_description"><p>Details about the action or <code class="literal">NULL</code>. </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>A set of <a class="link" href="PolkitAuthority.html#PolkitCheckAuthorizationFlags" title="enum PolkitCheckAuthorizationFlags"><span class="type">PolkitCheckAuthorizationFlags</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </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>Return location for error or <code class="literal">NULL</code>. </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>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-check-authorization-sync.returns"></a><h4>Returns</h4>
<p>A <a class="link" href="PolkitAuthorizationResult.html" title="PolkitAuthorizationResult"><span class="type">PolkitAuthorizationResult</span></a> or <code class="literal">NULL</code> if <em class="parameter"><code>error</code></em>
is set. Free with <code class="function">g_object_unref()</code>. </p>
<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-enumerate-actions"></a><h3>polkit_authority_enumerate_actions ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
polkit_authority_enumerate_actions (<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
<p>Asynchronously retrieves all registered actions.</p>
<p>When the operation is finished, <em class="parameter"><code>callback</code></em>
will be invoked in the</p>
<GTKDOCLINK HREF="g-main-context-push-thread-default">thread-default
main loop</GTKDOCLINK> of the thread you are calling this method
<p>from. You can then call <a class="link" href="PolkitAuthority.html#polkit-authority-enumerate-actions-finish" title="polkit_authority_enumerate_actions_finish ()"><code class="function">polkit_authority_enumerate_actions_finish()</code></a>
to get the result of the operation.</p>
<div class="refsect3">
<a name="polkit-authority-enumerate-actions.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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </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>A <span class="type">GAsyncReadyCallback</span> to call when the request is satisfied.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>The data to pass to <em class="parameter"><code>callback</code></em>
.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-enumerate-actions-finish"></a><h3>polkit_authority_enumerate_actions_finish ()</h3>
<pre class="programlisting"><span class="returnvalue">GList</span> *
polkit_authority_enumerate_actions_finish
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><span class="type">GAsyncResult</span> *res</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Finishes retrieving all registered actions.</p>
<div class="refsect3">
<a name="polkit-authority-enumerate-actions-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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>res</p></td>
<td class="parameter_description"><p>A <span class="type">GAsyncResult</span> obtained from the callback.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>Return location for error or <code class="literal">NULL</code>. </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>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-enumerate-actions-finish.returns"></a><h4>Returns</h4>
<p>A list of
<a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a> objects or <code class="literal">NULL</code> if <em class="parameter"><code>error</code></em>
is set. The returned
list should be freed with <code class="function">g_list_free()</code> after each element have been freed
with <code class="function">g_object_unref()</code>. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Polkit.ActionDescription][<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-enumerate-actions-sync"></a><h3>polkit_authority_enumerate_actions_sync ()</h3>
<pre class="programlisting"><span class="returnvalue">GList</span> *
polkit_authority_enumerate_actions_sync
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Synchronously retrieves all registered actions - the calling thread
is blocked until a reply is received. See
<a class="link" href="PolkitAuthority.html#polkit-authority-enumerate-actions" title="polkit_authority_enumerate_actions ()"><code class="function">polkit_authority_enumerate_actions()</code></a> for the asynchronous version.</p>
<div class="refsect3">
<a name="polkit-authority-enumerate-actions-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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </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>Return location for error or <code class="literal">NULL</code>. </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>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-enumerate-actions-sync.returns"></a><h4>Returns</h4>
<p>A list of
<a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a> or <code class="literal">NULL</code> if <em class="parameter"><code>error</code></em>
is set. The returned list should
be freed with <code class="function">g_list_free()</code> after each element have been freed with
<code class="function">g_object_unref()</code>. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Polkit.ActionDescription][<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-register-authentication-agent"></a><h3>polkit_authority_register_authentication_agent ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
polkit_authority_register_authentication_agent
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><a class="link" href="PolkitSubject.html" title="PolkitSubject"><span class="type">PolkitSubject</span></a> *subject</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *locale</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *object_path</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
<p>Asynchronously registers an authentication agent.</p>
<p>Note that this should be called by the same effective UID which will be
the real UID using the <a class="link" href="PolkitAgentSession.html" title="PolkitAgentSession"><span class="type">PolkitAgentSession</span></a> API or otherwise calling
<a class="link" href="PolkitAuthority.html#polkit-authority-authentication-agent-response" title="polkit_authority_authentication_agent_response ()"><code class="function">polkit_authority_authentication_agent_response()</code></a>.</p>
<p>When the operation is finished, <em class="parameter"><code>callback</code></em>
will be invoked in the</p>
<GTKDOCLINK HREF="g-main-context-push-thread-default">thread-default
main loop</GTKDOCLINK> of the thread you are calling this method
<p>from. You can then call
<a class="link" href="PolkitAuthority.html#polkit-authority-register-authentication-agent-finish" title="polkit_authority_register_authentication_agent_finish ()"><code class="function">polkit_authority_register_authentication_agent_finish()</code></a> to get the
result of the operation.</p>
<div class="refsect3">
<a name="polkit-authority-register-authentication-agent.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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>subject</p></td>
<td class="parameter_description"><p>The subject the authentication agent is for, typically a <a class="link" href="PolkitUnixSession.html" title="PolkitUnixSession"><span class="type">PolkitUnixSession</span></a> object.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>locale</p></td>
<td class="parameter_description"><p>The locale of the authentication agent.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>object_path</p></td>
<td class="parameter_description"><p>The object path for the authentication agent.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </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>A <span class="type">GAsyncReadyCallback</span> to call when the request is satisfied.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>The data to pass to <em class="parameter"><code>callback</code></em>
.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-register-authentication-agent-finish"></a><h3>polkit_authority_register_authentication_agent_finish ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
polkit_authority_register_authentication_agent_finish
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><span class="type">GAsyncResult</span> *res</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Finishes registering an authentication agent.</p>
<div class="refsect3">
<a name="polkit-authority-register-authentication-agent-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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>res</p></td>
<td class="parameter_description"><p>A <span class="type">GAsyncResult</span> obtained from the callback.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>Return location for error or <code class="literal">NULL</code>. </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>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-register-authentication-agent-finish.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the authentication agent was successfully registered, <code class="literal">FALSE</code> if <em class="parameter"><code>error</code></em>
is set.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-register-authentication-agent-sync"></a><h3>polkit_authority_register_authentication_agent_sync ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
polkit_authority_register_authentication_agent_sync
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><a class="link" href="PolkitSubject.html" title="PolkitSubject"><span class="type">PolkitSubject</span></a> *subject</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *locale</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *object_path</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Registers an authentication agent.</p>
<p>Note that this should be called by the same effective UID which will be
the real UID using the <a class="link" href="PolkitAgentSession.html" title="PolkitAgentSession"><span class="type">PolkitAgentSession</span></a> API or otherwise calling
<a class="link" href="PolkitAuthority.html#polkit-authority-authentication-agent-response" title="polkit_authority_authentication_agent_response ()"><code class="function">polkit_authority_authentication_agent_response()</code></a>.</p>
<p>The calling thread is blocked
until a reply is received. See
<a class="link" href="PolkitAuthority.html#polkit-authority-register-authentication-agent" title="polkit_authority_register_authentication_agent ()"><code class="function">polkit_authority_register_authentication_agent()</code></a> for the
asynchronous version.</p>
<div class="refsect3">
<a name="polkit-authority-register-authentication-agent-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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>subject</p></td>
<td class="parameter_description"><p>The subject the authentication agent is for, typically a <a class="link" href="PolkitUnixSession.html" title="PolkitUnixSession"><span class="type">PolkitUnixSession</span></a> object.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>locale</p></td>
<td class="parameter_description"><p>The locale of the authentication agent.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>object_path</p></td>
<td class="parameter_description"><p>The object path for the authentication agent.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </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>Return location for error or <code class="literal">NULL</code>. </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>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-register-authentication-agent-sync.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the authentication agent was successfully registered, <code class="literal">FALSE</code> if <em class="parameter"><code>error</code></em>
is set.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-register-authentication-agent-with-options"></a><h3>polkit_authority_register_authentication_agent_with_options ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
polkit_authority_register_authentication_agent_with_options
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><a class="link" href="PolkitSubject.html" title="PolkitSubject"><span class="type">PolkitSubject</span></a> *subject</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *locale</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *object_path</code></em>,
<em class="parameter"><code><span class="type">GVariant</span> *options</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
<p>Asynchronously registers an authentication agent.</p>
<p>Note that this should be called by the same effective UID which will be
the real UID using the <a class="link" href="PolkitAgentSession.html" title="PolkitAgentSession"><span class="type">PolkitAgentSession</span></a> API or otherwise calling
<a class="link" href="PolkitAuthority.html#polkit-authority-authentication-agent-response" title="polkit_authority_authentication_agent_response ()"><code class="function">polkit_authority_authentication_agent_response()</code></a>.</p>
<p>When the operation is finished, <em class="parameter"><code>callback</code></em>
will be invoked in the</p>
<GTKDOCLINK HREF="g-main-context-push-thread-default">thread-default
main loop</GTKDOCLINK> of the thread you are calling this method
<p>from. You can then call
<a class="link" href="PolkitAuthority.html#polkit-authority-register-authentication-agent-with-options-finish" title="polkit_authority_register_authentication_agent_with_options_finish ()"><code class="function">polkit_authority_register_authentication_agent_with_options_finish()</code></a> to get the
result of the operation.</p>
<div class="refsect3">
<a name="polkit-authority-register-authentication-agent-with-options.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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>subject</p></td>
<td class="parameter_description"><p>The subject the authentication agent is for, typically a <a class="link" href="PolkitUnixSession.html" title="PolkitUnixSession"><span class="type">PolkitUnixSession</span></a> object.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>locale</p></td>
<td class="parameter_description"><p>The locale of the authentication agent.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>object_path</p></td>
<td class="parameter_description"><p>The object path for the authentication agent.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>options</p></td>
<td class="parameter_description"><p>A <span class="type">GVariant</span> with options or <code class="literal">NULL</code>. </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>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </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>A <span class="type">GAsyncReadyCallback</span> to call when the request is satisfied.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>The data to pass to <em class="parameter"><code>callback</code></em>
.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-register-authentication-agent-with-options-finish"></a><h3>polkit_authority_register_authentication_agent_with_options_finish ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
polkit_authority_register_authentication_agent_with_options_finish
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><span class="type">GAsyncResult</span> *res</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Finishes registering an authentication agent.</p>
<div class="refsect3">
<a name="polkit-authority-register-authentication-agent-with-options-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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>res</p></td>
<td class="parameter_description"><p>A <span class="type">GAsyncResult</span> obtained from the callback.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>Return location for error or <code class="literal">NULL</code>. </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>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-register-authentication-agent-with-options-finish.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the authentication agent was successfully registered, <code class="literal">FALSE</code> if <em class="parameter"><code>error</code></em>
is set.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-register-authentication-agent-with-options-sync"></a><h3>polkit_authority_register_authentication_agent_with_options_sync ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
polkit_authority_register_authentication_agent_with_options_sync
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><a class="link" href="PolkitSubject.html" title="PolkitSubject"><span class="type">PolkitSubject</span></a> *subject</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *locale</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *object_path</code></em>,
<em class="parameter"><code><span class="type">GVariant</span> *options</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Registers an authentication agent.</p>
<p>Note that this should be called by the same effective UID which will be
the real UID using the <a class="link" href="PolkitAgentSession.html" title="PolkitAgentSession"><span class="type">PolkitAgentSession</span></a> API or otherwise calling
<a class="link" href="PolkitAuthority.html#polkit-authority-authentication-agent-response" title="polkit_authority_authentication_agent_response ()"><code class="function">polkit_authority_authentication_agent_response()</code></a>.</p>
<p>The calling thread is blocked
until a reply is received. See
<a class="link" href="PolkitAuthority.html#polkit-authority-register-authentication-agent-with-options" title="polkit_authority_register_authentication_agent_with_options ()"><code class="function">polkit_authority_register_authentication_agent_with_options()</code></a> for the
asynchronous version.</p>
<div class="refsect3">
<a name="polkit-authority-register-authentication-agent-with-options-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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>subject</p></td>
<td class="parameter_description"><p>The subject the authentication agent is for, typically a <a class="link" href="PolkitUnixSession.html" title="PolkitUnixSession"><span class="type">PolkitUnixSession</span></a> object.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>locale</p></td>
<td class="parameter_description"><p>The locale of the authentication agent.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>object_path</p></td>
<td class="parameter_description"><p>The object path for the authentication agent.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>options</p></td>
<td class="parameter_description"><p>A <span class="type">GVariant</span> with options or <code class="literal">NULL</code>. </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>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </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>Return location for error or <code class="literal">NULL</code>. </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>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-register-authentication-agent-with-options-sync.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the authentication agent was successfully registered, <code class="literal">FALSE</code> if <em class="parameter"><code>error</code></em>
is set.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-unregister-authentication-agent"></a><h3>polkit_authority_unregister_authentication_agent ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
polkit_authority_unregister_authentication_agent
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><a class="link" href="PolkitSubject.html" title="PolkitSubject"><span class="type">PolkitSubject</span></a> *subject</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *object_path</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
<p>Asynchronously unregisters an authentication agent.</p>
<p>When the operation is finished, <em class="parameter"><code>callback</code></em>
will be invoked in the</p>
<GTKDOCLINK HREF="g-main-context-push-thread-default">thread-default
main loop</GTKDOCLINK> of the thread you are calling this method
<p>from. You can then call
<a class="link" href="PolkitAuthority.html#polkit-authority-unregister-authentication-agent-finish" title="polkit_authority_unregister_authentication_agent_finish ()"><code class="function">polkit_authority_unregister_authentication_agent_finish()</code></a> to get
the result of the operation.</p>
<div class="refsect3">
<a name="polkit-authority-unregister-authentication-agent.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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>subject</p></td>
<td class="parameter_description"><p>The subject the authentication agent is for, typically a <a class="link" href="PolkitUnixSession.html" title="PolkitUnixSession"><span class="type">PolkitUnixSession</span></a> object.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>object_path</p></td>
<td class="parameter_description"><p>The object path for the authentication agent.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </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>A <span class="type">GAsyncReadyCallback</span> to call when the request is satisfied.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>The data to pass to <em class="parameter"><code>callback</code></em>
.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-unregister-authentication-agent-finish"></a><h3>polkit_authority_unregister_authentication_agent_finish ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
polkit_authority_unregister_authentication_agent_finish
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><span class="type">GAsyncResult</span> *res</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Finishes unregistering an authentication agent.</p>
<div class="refsect3">
<a name="polkit-authority-unregister-authentication-agent-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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>res</p></td>
<td class="parameter_description"><p>A <span class="type">GAsyncResult</span> obtained from the callback.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>Return location for error or <code class="literal">NULL</code>. </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>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-unregister-authentication-agent-finish.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the authentication agent was successfully unregistered, <code class="literal">FALSE</code> if <em class="parameter"><code>error</code></em>
is set.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-unregister-authentication-agent-sync"></a><h3>polkit_authority_unregister_authentication_agent_sync ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
polkit_authority_unregister_authentication_agent_sync
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><a class="link" href="PolkitSubject.html" title="PolkitSubject"><span class="type">PolkitSubject</span></a> *subject</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *object_path</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Unregisters an authentication agent. The calling thread is blocked
until a reply is received. See
<a class="link" href="PolkitAuthority.html#polkit-authority-unregister-authentication-agent" title="polkit_authority_unregister_authentication_agent ()"><code class="function">polkit_authority_unregister_authentication_agent()</code></a> for the
asynchronous version.</p>
<div class="refsect3">
<a name="polkit-authority-unregister-authentication-agent-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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>subject</p></td>
<td class="parameter_description"><p>The subject the authentication agent is for, typically a <a class="link" href="PolkitUnixSession.html" title="PolkitUnixSession"><span class="type">PolkitUnixSession</span></a> object.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>object_path</p></td>
<td class="parameter_description"><p>The object path for the authentication agent.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </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>Return location for error or <code class="literal">NULL</code>. </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>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-unregister-authentication-agent-sync.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the authentication agent was successfully unregistered, <code class="literal">FALSE</code> if <em class="parameter"><code>error</code></em>
is set.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-authentication-agent-response"></a><h3>polkit_authority_authentication_agent_response ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
polkit_authority_authentication_agent_response
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *cookie</code></em>,
<em class="parameter"><code><a class="link" href="PolkitIdentity.html" title="PolkitIdentity"><span class="type">PolkitIdentity</span></a> *identity</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
<p>Asynchronously provide response that <em class="parameter"><code>identity</code></em>
successfully authenticated
for the authentication request identified by <em class="parameter"><code>cookie</code></em>
.</p>
<p>This function is only used by the privileged bits of an authentication agent.
It will fail if the caller is not sufficiently privileged (typically uid 0).</p>
<p>When the operation is finished, <em class="parameter"><code>callback</code></em>
will be invoked in the</p>
<GTKDOCLINK HREF="g-main-context-push-thread-default">thread-default
main loop</GTKDOCLINK> of the thread you are calling this method
<p>from. You can then call
<a class="link" href="PolkitAuthority.html#polkit-authority-authentication-agent-response-finish" title="polkit_authority_authentication_agent_response_finish ()"><code class="function">polkit_authority_authentication_agent_response_finish()</code></a> to get the
result of the operation.</p>
<div class="refsect3">
<a name="polkit-authority-authentication-agent-response.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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cookie</p></td>
<td class="parameter_description"><p>The cookie passed to the authentication agent from the authority.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>identity</p></td>
<td class="parameter_description"><p>The identity that was authenticated.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </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>A <span class="type">GAsyncReadyCallback</span> to call when the request is satisfied.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>The data to pass to <em class="parameter"><code>callback</code></em>
.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-authentication-agent-response-finish"></a><h3>polkit_authority_authentication_agent_response_finish ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
polkit_authority_authentication_agent_response_finish
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><span class="type">GAsyncResult</span> *res</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Finishes providing response from an authentication agent.</p>
<div class="refsect3">
<a name="polkit-authority-authentication-agent-response-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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>res</p></td>
<td class="parameter_description"><p>A <span class="type">GAsyncResult</span> obtained from the callback.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>Return location for error or <code class="literal">NULL</code>. </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>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-authentication-agent-response-finish.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>authority</code></em>
acknowledged the call, <code class="literal">FALSE</code> if <em class="parameter"><code>error</code></em>
is set.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-authentication-agent-response-sync"></a><h3>polkit_authority_authentication_agent_response_sync ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
polkit_authority_authentication_agent_response_sync
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *cookie</code></em>,
<em class="parameter"><code><a class="link" href="PolkitIdentity.html" title="PolkitIdentity"><span class="type">PolkitIdentity</span></a> *identity</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Provide response that <em class="parameter"><code>identity</code></em>
successfully authenticated for the
authentication request identified by <em class="parameter"><code>cookie</code></em>
. See <a class="link" href="PolkitAuthority.html#polkit-authority-authentication-agent-response" title="polkit_authority_authentication_agent_response ()"><code class="function">polkit_authority_authentication_agent_response()</code></a>
for limitations on who is allowed is to call this method.</p>
<p>The calling thread is blocked until a reply is received. See
<a class="link" href="PolkitAuthority.html#polkit-authority-authentication-agent-response" title="polkit_authority_authentication_agent_response ()"><code class="function">polkit_authority_authentication_agent_response()</code></a> for the
asynchronous version.</p>
<div class="refsect3">
<a name="polkit-authority-authentication-agent-response-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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cookie</p></td>
<td class="parameter_description"><p>The cookie passed to the authentication agent from the authority.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>identity</p></td>
<td class="parameter_description"><p>The identity that was authenticated.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </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>Return location for error or <code class="literal">NULL</code>. </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>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-authentication-agent-response-sync.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>authority</code></em>
acknowledged the call, <code class="literal">FALSE</code> if <em class="parameter"><code>error</code></em>
is set.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-enumerate-temporary-authorizations"></a><h3>polkit_authority_enumerate_temporary_authorizations ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
polkit_authority_enumerate_temporary_authorizations
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><a class="link" href="PolkitSubject.html" title="PolkitSubject"><span class="type">PolkitSubject</span></a> *subject</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
<p>Asynchronously gets all temporary authorizations for <em class="parameter"><code>subject</code></em>
.</p>
<p>When the operation is finished, <em class="parameter"><code>callback</code></em>
will be invoked in the</p>
<GTKDOCLINK HREF="g-main-context-push-thread-default">thread-default
main loop</GTKDOCLINK> of the thread you are calling this method
<p>from. You can then call
<a class="link" href="PolkitAuthority.html#polkit-authority-enumerate-temporary-authorizations-finish" title="polkit_authority_enumerate_temporary_authorizations_finish ()"><code class="function">polkit_authority_enumerate_temporary_authorizations_finish()</code></a> to get
the result of the operation.</p>
<div class="refsect3">
<a name="polkit-authority-enumerate-temporary-authorizations.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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>subject</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitSubject.html" title="PolkitSubject"><span class="type">PolkitSubject</span></a>, typically a <a class="link" href="PolkitUnixSession.html" title="PolkitUnixSession"><span class="type">PolkitUnixSession</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </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>A <span class="type">GAsyncReadyCallback</span> to call when the request is satisfied.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>The data to pass to <em class="parameter"><code>callback</code></em>
.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-enumerate-temporary-authorizations-finish"></a><h3>polkit_authority_enumerate_temporary_authorizations_finish ()</h3>
<pre class="programlisting"><span class="returnvalue">GList</span> *
polkit_authority_enumerate_temporary_authorizations_finish
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><span class="type">GAsyncResult</span> *res</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Finishes retrieving all registered actions.</p>
<div class="refsect3">
<a name="polkit-authority-enumerate-temporary-authorizations-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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>res</p></td>
<td class="parameter_description"><p>A <span class="type">GAsyncResult</span> obtained from the callback.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>Return location for error or <code class="literal">NULL</code>. </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>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-enumerate-temporary-authorizations-finish.returns"></a><h4>Returns</h4>
<p>A
list of <a class="link" href="PolkitTemporaryAuthorization.html" title="PolkitTemporaryAuthorization"><span class="type">PolkitTemporaryAuthorization</span></a> objects or <code class="literal">NULL</code> if <em class="parameter"><code>error</code></em>
is set. The
returned list should be freed with <code class="function">g_list_free()</code> after each element have
been freed with <code class="function">g_object_unref()</code>. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Polkit.TemporaryAuthorization][<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-enumerate-temporary-authorizations-sync"></a><h3>polkit_authority_enumerate_temporary_authorizations_sync ()</h3>
<pre class="programlisting"><span class="returnvalue">GList</span> *
polkit_authority_enumerate_temporary_authorizations_sync
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><a class="link" href="PolkitSubject.html" title="PolkitSubject"><span class="type">PolkitSubject</span></a> *subject</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Synchronousky gets all temporary authorizations for <em class="parameter"><code>subject</code></em>
.</p>
<p>The calling thread is blocked until a reply is received. See
<a class="link" href="PolkitAuthority.html#polkit-authority-enumerate-temporary-authorizations" title="polkit_authority_enumerate_temporary_authorizations ()"><code class="function">polkit_authority_enumerate_temporary_authorizations()</code></a> for the
asynchronous version.</p>
<div class="refsect3">
<a name="polkit-authority-enumerate-temporary-authorizations-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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>subject</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitSubject.html" title="PolkitSubject"><span class="type">PolkitSubject</span></a>, typically a <a class="link" href="PolkitUnixSession.html" title="PolkitUnixSession"><span class="type">PolkitUnixSession</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </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>Return location for error or <code class="literal">NULL</code>. </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>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-enumerate-temporary-authorizations-sync.returns"></a><h4>Returns</h4>
<p>A
list of <a class="link" href="PolkitTemporaryAuthorization.html" title="PolkitTemporaryAuthorization"><span class="type">PolkitTemporaryAuthorization</span></a> objects or <code class="literal">NULL</code> if <em class="parameter"><code>error</code></em>
is set. The
returned list should be freed with <code class="function">g_list_free()</code> after each element have
been freed with <code class="function">g_object_unref()</code>. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Polkit.TemporaryAuthorization][<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-revoke-temporary-authorizations"></a><h3>polkit_authority_revoke_temporary_authorizations ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
polkit_authority_revoke_temporary_authorizations
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><a class="link" href="PolkitSubject.html" title="PolkitSubject"><span class="type">PolkitSubject</span></a> *subject</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
<p>Asynchronously revokes all temporary authorizations for <em class="parameter"><code>subject</code></em>
.</p>
<p>When the operation is finished, <em class="parameter"><code>callback</code></em>
will be invoked in the</p>
<GTKDOCLINK HREF="g-main-context-push-thread-default">thread-default
main loop</GTKDOCLINK> of the thread you are calling this method
<p>from. You can then call
<a class="link" href="PolkitAuthority.html#polkit-authority-revoke-temporary-authorizations-finish" title="polkit_authority_revoke_temporary_authorizations_finish ()"><code class="function">polkit_authority_revoke_temporary_authorizations_finish()</code></a> to get
the result of the operation.</p>
<div class="refsect3">
<a name="polkit-authority-revoke-temporary-authorizations.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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>subject</p></td>
<td class="parameter_description"><p>The subject to revoke authorizations from, typically a <a class="link" href="PolkitUnixSession.html" title="PolkitUnixSession"><span class="type">PolkitUnixSession</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </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>A <span class="type">GAsyncReadyCallback</span> to call when the request is satisfied.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>The data to pass to <em class="parameter"><code>callback</code></em>
.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-revoke-temporary-authorizations-finish"></a><h3>polkit_authority_revoke_temporary_authorizations_finish ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
polkit_authority_revoke_temporary_authorizations_finish
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><span class="type">GAsyncResult</span> *res</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Finishes revoking temporary authorizations.</p>
<div class="refsect3">
<a name="polkit-authority-revoke-temporary-authorizations-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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>res</p></td>
<td class="parameter_description"><p>A <span class="type">GAsyncResult</span> obtained from the callback.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>Return location for error or <code class="literal">NULL</code>. </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>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-revoke-temporary-authorizations-finish.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if all the temporary authorizations was revoked, <code class="literal">FALSE</code> if error is set.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-revoke-temporary-authorizations-sync"></a><h3>polkit_authority_revoke_temporary_authorizations_sync ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
polkit_authority_revoke_temporary_authorizations_sync
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><a class="link" href="PolkitSubject.html" title="PolkitSubject"><span class="type">PolkitSubject</span></a> *subject</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Synchronously revokes all temporary authorization from <em class="parameter"><code>subject</code></em>
.</p>
<p>The calling thread is blocked until a reply is received. See
<a class="link" href="PolkitAuthority.html#polkit-authority-revoke-temporary-authorizations" title="polkit_authority_revoke_temporary_authorizations ()"><code class="function">polkit_authority_revoke_temporary_authorizations()</code></a> for the
asynchronous version.</p>
<div class="refsect3">
<a name="polkit-authority-revoke-temporary-authorizations-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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>subject</p></td>
<td class="parameter_description"><p>The subject to revoke authorizations from, typically a <a class="link" href="PolkitUnixSession.html" title="PolkitUnixSession"><span class="type">PolkitUnixSession</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </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>Return location for error or <code class="literal">NULL</code>. </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>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-revoke-temporary-authorizations-sync.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the temporary authorization was revoked, <code class="literal">FALSE</code> if error is set.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-revoke-temporary-authorization-by-id"></a><h3>polkit_authority_revoke_temporary_authorization_by_id ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
polkit_authority_revoke_temporary_authorization_by_id
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *id</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
<p>Asynchronously revoke a temporary authorization.</p>
<p>When the operation is finished, <em class="parameter"><code>callback</code></em>
will be invoked in the</p>
<GTKDOCLINK HREF="g-main-context-push-thread-default">thread-default
main loop</GTKDOCLINK> of the thread you are calling this method
<p>from. You can then call
<a class="link" href="PolkitAuthority.html#polkit-authority-revoke-temporary-authorization-by-id-finish" title="polkit_authority_revoke_temporary_authorization_by_id_finish ()"><code class="function">polkit_authority_revoke_temporary_authorization_by_id_finish()</code></a> to
get the result of the operation.</p>
<div class="refsect3">
<a name="polkit-authority-revoke-temporary-authorization-by-id.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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>id</p></td>
<td class="parameter_description"><p>The opaque identifier for the temporary authorization.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </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>A <span class="type">GAsyncReadyCallback</span> to call when the request is satisfied.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>The data to pass to <em class="parameter"><code>callback</code></em>
.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-revoke-temporary-authorization-by-id-finish"></a><h3>polkit_authority_revoke_temporary_authorization_by_id_finish ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
polkit_authority_revoke_temporary_authorization_by_id_finish
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code><span class="type">GAsyncResult</span> *res</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Finishes revoking a temporary authorization by id.</p>
<div class="refsect3">
<a name="polkit-authority-revoke-temporary-authorization-by-id-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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>res</p></td>
<td class="parameter_description"><p>A <span class="type">GAsyncResult</span> obtained from the callback.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>Return location for error or <code class="literal">NULL</code>. </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>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-revoke-temporary-authorization-by-id-finish.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the temporary authorization was revoked, <code class="literal">FALSE</code> if error is set.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="polkit-authority-revoke-temporary-authorization-by-id-sync"></a><h3>polkit_authority_revoke_temporary_authorization_by_id_sync ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
polkit_authority_revoke_temporary_authorization_by_id_sync
(<em class="parameter"><code><a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *id</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Synchronously revokes a temporary authorization.</p>
<p>The calling thread is blocked until a reply is received. See
<a class="link" href="PolkitAuthority.html#polkit-authority-revoke-temporary-authorization-by-id" title="polkit_authority_revoke_temporary_authorization_by_id ()"><code class="function">polkit_authority_revoke_temporary_authorization_by_id()</code></a> for the
asynchronous version.</p>
<div class="refsect3">
<a name="polkit-authority-revoke-temporary-authorization-by-id-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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>id</p></td>
<td class="parameter_description"><p>The opaque identifier for the temporary authorization.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </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>Return location for error or <code class="literal">NULL</code>. </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>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="polkit-authority-revoke-temporary-authorization-by-id-sync.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the temporary authorization was revoked, <code class="literal">FALSE</code> if error is set.</p>
</div>
</div>
</div>
<div class="refsect1">
<a name="PolkitAuthority.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="PolkitAuthority-struct"></a><h3>PolkitAuthority</h3>
<pre class="programlisting">typedef struct _PolkitAuthority PolkitAuthority;</pre>
<p>The <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> struct should not be accessed directly.</p>
</div>
<hr>
<div class="refsect2">
<a name="PolkitAuthorityFeatures"></a><h3>enum PolkitAuthorityFeatures</h3>
<p>Flags describing features supported by the Authority implementation.</p>
<div class="refsect3">
<a name="PolkitAuthorityFeatures.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="POLKIT-AUTHORITY-FEATURES-NONE:CAPS"></a>POLKIT_AUTHORITY_FEATURES_NONE</p></td>
<td class="enum_member_description">
<p>No flags set.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="POLKIT-AUTHORITY-FEATURES-TEMPORARY-AUTHORIZATION:CAPS"></a>POLKIT_AUTHORITY_FEATURES_TEMPORARY_AUTHORIZATION</p></td>
<td class="enum_member_description">
<p>The authority supports temporary authorizations
that can be obtained through authentication.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="PolkitCheckAuthorizationFlags"></a><h3>enum PolkitCheckAuthorizationFlags</h3>
<p>Possible flags when checking authorizations.</p>
<div class="refsect3">
<a name="PolkitCheckAuthorizationFlags.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="POLKIT-CHECK-AUTHORIZATION-FLAGS-NONE:CAPS"></a>POLKIT_CHECK_AUTHORIZATION_FLAGS_NONE</p></td>
<td class="enum_member_description">
<p>No flags set.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="POLKIT-CHECK-AUTHORIZATION-FLAGS-ALLOW-USER-INTERACTION:CAPS"></a>POLKIT_CHECK_AUTHORIZATION_FLAGS_ALLOW_USER_INTERACTION</p></td>
<td class="enum_member_description">
<p>If the subject can obtain the authorization
through authentication, and an authentication agent is available, then attempt to do so. Note, this
means that the method used for checking authorization is likely to block for a long time.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="refsect1">
<a name="PolkitAuthority.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="PolkitAuthority--backend-features"></a><h3>The <code class="literal">“backend-features”</code> property</h3>
<pre class="programlisting"> “backend-features” <a class="link" href="PolkitAuthority.html#PolkitAuthorityFeatures" title="enum PolkitAuthorityFeatures"><span class="type">PolkitAuthorityFeatures</span></a></pre>
<p>The features of the currently used Authority backend.</p>
<p>Owner: PolkitAuthority</p>
<p>Flags: Read</p>
</div>
<hr>
<div class="refsect2">
<a name="PolkitAuthority--backend-name"></a><h3>The <code class="literal">“backend-name”</code> property</h3>
<pre class="programlisting"> “backend-name” <span class="type">char</span> *</pre>
<p>The name of the currently used Authority backend.</p>
<p>Owner: PolkitAuthority</p>
<p>Flags: Read</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2">
<a name="PolkitAuthority--backend-version"></a><h3>The <code class="literal">“backend-version”</code> property</h3>
<pre class="programlisting"> “backend-version” <span class="type">char</span> *</pre>
<p>The version of the currently used Authority backend.</p>
<p>Owner: PolkitAuthority</p>
<p>Flags: Read</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2">
<a name="PolkitAuthority--owner"></a><h3>The <code class="literal">“owner”</code> property</h3>
<pre class="programlisting"> “owner” <span class="type">char</span> *</pre>
<p>The unique name of the owner of the org.freedesktop.PolicyKit1
D-Bus service or <code class="literal">NULL</code> if there is no owner. Connect to the
<span class="type">“notify”</span> signal to track changes to this property.</p>
<p>Owner: PolkitAuthority</p>
<p>Flags: Read</p>
<p>Default value: NULL</p>
</div>
</div>
<div class="refsect1">
<a name="PolkitAuthority.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2">
<a name="PolkitAuthority-changed"></a><h3>The <code class="literal">“changed”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority,
<span class="type">gpointer</span> user_data)</pre>
<p>Emitted when actions and/or authorizations change</p>
<div class="refsect3">
<a name="PolkitAuthority-changed.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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Run Last</p>
</div>
<hr>
<div class="refsect2">
<a name="PolkitAuthority-sessions-changed"></a><h3>The <code class="literal">“sessions-changed”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a> *authority,
<span class="type">gpointer</span> user_data)</pre>
<p>Emitted when sessions change</p>
<div class="refsect3">
<a name="PolkitAuthority-sessions-changed.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>authority</p></td>
<td class="parameter_description"><p>A <a class="link" href="PolkitAuthority.html" title="PolkitAuthority"><span class="type">PolkitAuthority</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Run Last</p>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.33.1</div>
</body>
</html>