41
33
<h2><span class="refentrytitle"><a name="GoaOAuth2Based.top_of_page"></a>GoaOAuth2Based</span></h2>
42
34
<p>GoaOAuth2Based — Generated C code for the org.gnome.OnlineAccounts.OAuth2Based D-Bus interface</p>
44
<td valign="top" align="right"></td>
36
<td class="gallery_image" valign="top" align="right"></td>
45
37
</tr></table></div>
46
<div class="refsynopsisdiv">
47
<a name="GoaOAuth2Based.synopsis"></a><h2>Synopsis</h2>
48
<pre class="synopsis"> <a class="link" href="GoaOAuth2Based.html#GoaOAuth2Based-struct" title="GoaOAuth2Based">GoaOAuth2Based</a>;
49
struct <a class="link" href="GoaOAuth2Based.html#GoaOAuth2BasedIface" title="struct GoaOAuth2BasedIface">GoaOAuth2BasedIface</a>;
50
<span class="returnvalue">GDBusInterfaceInfo</span> * <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-interface-info" title="goa_oauth2_based_interface_info ()">goa_oauth2_based_interface_info</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
51
<span class="returnvalue">guint</span> <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-override-properties" title="goa_oauth2_based_override_properties ()">goa_oauth2_based_override_properties</a>
52
(<em class="parameter"><code><span class="type">GObjectClass</span> *klass</code></em>,
53
<em class="parameter"><code><span class="type">guint</span> property_id_begin</code></em>);
54
const <span class="returnvalue">gchar</span> * <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-get-client-id" title="goa_oauth2_based_get_client_id ()">goa_oauth2_based_get_client_id</a> (<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *object</code></em>);
55
<span class="returnvalue">void</span> <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-set-client-id" title="goa_oauth2_based_set_client_id ()">goa_oauth2_based_set_client_id</a> (<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *object</code></em>,
56
<em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);
57
<span class="returnvalue">gchar</span> * <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-dup-client-id" title="goa_oauth2_based_dup_client_id ()">goa_oauth2_based_dup_client_id</a> (<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *object</code></em>);
58
const <span class="returnvalue">gchar</span> * <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-get-client-secret" title="goa_oauth2_based_get_client_secret ()">goa_oauth2_based_get_client_secret</a> (<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *object</code></em>);
59
<span class="returnvalue">void</span> <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-set-client-secret" title="goa_oauth2_based_set_client_secret ()">goa_oauth2_based_set_client_secret</a> (<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *object</code></em>,
60
<em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);
61
<span class="returnvalue">gchar</span> * <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-dup-client-secret" title="goa_oauth2_based_dup_client_secret ()">goa_oauth2_based_dup_client_secret</a> (<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *object</code></em>);
62
<span class="returnvalue">void</span> <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-call-get-access-token" title="goa_oauth2_based_call_get_access_token ()">goa_oauth2_based_call_get_access_token</a>
63
(<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *proxy</code></em>,
64
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
65
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
66
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);
67
<span class="returnvalue">gboolean</span> <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-call-get-access-token-finish" title="goa_oauth2_based_call_get_access_token_finish ()">goa_oauth2_based_call_get_access_token_finish</a>
68
(<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *proxy</code></em>,
69
<em class="parameter"><code><span class="type">gchar</span> **out_access_token</code></em>,
70
<em class="parameter"><code><span class="type">gint</span> *out_expires_in</code></em>,
71
<em class="parameter"><code><span class="type">GAsyncResult</span> *res</code></em>,
72
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);
73
<span class="returnvalue">gboolean</span> <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-call-get-access-token-sync" title="goa_oauth2_based_call_get_access_token_sync ()">goa_oauth2_based_call_get_access_token_sync</a>
74
(<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *proxy</code></em>,
75
<em class="parameter"><code><span class="type">gchar</span> **out_access_token</code></em>,
76
<em class="parameter"><code><span class="type">gint</span> *out_expires_in</code></em>,
77
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
78
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);
79
<span class="returnvalue">void</span> <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-complete-get-access-token" title="goa_oauth2_based_complete_get_access_token ()">goa_oauth2_based_complete_get_access_token</a>
80
(<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *object</code></em>,
81
<em class="parameter"><code><span class="type">GDBusMethodInvocation</span> *invocation</code></em>,
82
<em class="parameter"><code>const <span class="type">gchar</span> *access_token</code></em>,
83
<em class="parameter"><code><span class="type">gint</span> expires_in</code></em>);
84
struct <a class="link" href="GoaOAuth2Based.html#GoaOAuth2BasedProxy" title="struct GoaOAuth2BasedProxy">GoaOAuth2BasedProxy</a>;
85
struct <a class="link" href="GoaOAuth2Based.html#GoaOAuth2BasedProxyClass" title="struct GoaOAuth2BasedProxyClass">GoaOAuth2BasedProxyClass</a>;
86
<span class="returnvalue">void</span> <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new" title="goa_oauth2_based_proxy_new ()">goa_oauth2_based_proxy_new</a> (<em class="parameter"><code><span class="type">GDBusConnection</span> *connection</code></em>,
87
<em class="parameter"><code><span class="type">GDBusProxyFlags</span> flags</code></em>,
88
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
89
<em class="parameter"><code>const <span class="type">gchar</span> *object_path</code></em>,
90
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
91
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
92
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);
93
<a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="returnvalue">GoaOAuth2Based</span></a> * <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-finish" title="goa_oauth2_based_proxy_new_finish ()">goa_oauth2_based_proxy_new_finish</a> (<em class="parameter"><code><span class="type">GAsyncResult</span> *res</code></em>,
94
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);
95
<a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="returnvalue">GoaOAuth2Based</span></a> * <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-sync" title="goa_oauth2_based_proxy_new_sync ()">goa_oauth2_based_proxy_new_sync</a> (<em class="parameter"><code><span class="type">GDBusConnection</span> *connection</code></em>,
96
<em class="parameter"><code><span class="type">GDBusProxyFlags</span> flags</code></em>,
97
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
98
<em class="parameter"><code>const <span class="type">gchar</span> *object_path</code></em>,
99
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
100
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);
101
<span class="returnvalue">void</span> <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-for-bus" title="goa_oauth2_based_proxy_new_for_bus ()">goa_oauth2_based_proxy_new_for_bus</a> (<em class="parameter"><code><span class="type">GBusType</span> bus_type</code></em>,
102
<em class="parameter"><code><span class="type">GDBusProxyFlags</span> flags</code></em>,
103
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
104
<em class="parameter"><code>const <span class="type">gchar</span> *object_path</code></em>,
105
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
106
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
107
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);
108
<a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="returnvalue">GoaOAuth2Based</span></a> * <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-for-bus-finish" title="goa_oauth2_based_proxy_new_for_bus_finish ()">goa_oauth2_based_proxy_new_for_bus_finish</a>
109
(<em class="parameter"><code><span class="type">GAsyncResult</span> *res</code></em>,
110
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);
111
<a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="returnvalue">GoaOAuth2Based</span></a> * <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-for-bus-sync" title="goa_oauth2_based_proxy_new_for_bus_sync ()">goa_oauth2_based_proxy_new_for_bus_sync</a>
112
(<em class="parameter"><code><span class="type">GBusType</span> bus_type</code></em>,
113
<em class="parameter"><code><span class="type">GDBusProxyFlags</span> flags</code></em>,
114
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
115
<em class="parameter"><code>const <span class="type">gchar</span> *object_path</code></em>,
116
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
117
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);
118
struct <a class="link" href="GoaOAuth2Based.html#GoaOAuth2BasedSkeleton" title="struct GoaOAuth2BasedSkeleton">GoaOAuth2BasedSkeleton</a>;
119
struct <a class="link" href="GoaOAuth2Based.html#GoaOAuth2BasedSkeletonClass" title="struct GoaOAuth2BasedSkeletonClass">GoaOAuth2BasedSkeletonClass</a>;
120
<a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="returnvalue">GoaOAuth2Based</span></a> * <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-skeleton-new" title="goa_oauth2_based_skeleton_new ()">goa_oauth2_based_skeleton_new</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
38
<div class="refsect1">
39
<a name="GoaOAuth2Based.functions"></a><h2>Functions</h2>
40
<div class="informaltable"><table width="100%" border="0">
42
<col width="150px" class="functions_return">
43
<col class="functions_name">
47
<td class="function_type">
48
<a href="http://library.gnome.org/devel/gio/unstable/gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo"><span class="returnvalue">GDBusInterfaceInfo</span></a> *
50
<td class="function_name">
51
<a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-interface-info" title="goa_oauth2_based_interface_info ()">goa_oauth2_based_interface_info</a> <span class="c_punctuation">()</span>
55
<td class="function_type">
56
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
58
<td class="function_name">
59
<a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-override-properties" title="goa_oauth2_based_override_properties ()">goa_oauth2_based_override_properties</a> <span class="c_punctuation">()</span>
63
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
65
<td class="function_name">
66
<a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-get-client-id" title="goa_oauth2_based_get_client_id ()">goa_oauth2_based_get_client_id</a> <span class="c_punctuation">()</span>
70
<td class="function_type">
71
<span class="returnvalue">void</span>
73
<td class="function_name">
74
<a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-set-client-id" title="goa_oauth2_based_set_client_id ()">goa_oauth2_based_set_client_id</a> <span class="c_punctuation">()</span>
78
<td class="function_type">
79
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
81
<td class="function_name">
82
<a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-dup-client-id" title="goa_oauth2_based_dup_client_id ()">goa_oauth2_based_dup_client_id</a> <span class="c_punctuation">()</span>
86
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
88
<td class="function_name">
89
<a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-get-client-secret" title="goa_oauth2_based_get_client_secret ()">goa_oauth2_based_get_client_secret</a> <span class="c_punctuation">()</span>
93
<td class="function_type">
94
<span class="returnvalue">void</span>
96
<td class="function_name">
97
<a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-set-client-secret" title="goa_oauth2_based_set_client_secret ()">goa_oauth2_based_set_client_secret</a> <span class="c_punctuation">()</span>
101
<td class="function_type">
102
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
104
<td class="function_name">
105
<a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-dup-client-secret" title="goa_oauth2_based_dup_client_secret ()">goa_oauth2_based_dup_client_secret</a> <span class="c_punctuation">()</span>
109
<td class="function_type">
110
<span class="returnvalue">void</span>
112
<td class="function_name">
113
<a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-call-get-access-token" title="goa_oauth2_based_call_get_access_token ()">goa_oauth2_based_call_get_access_token</a> <span class="c_punctuation">()</span>
117
<td class="function_type">
118
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
120
<td class="function_name">
121
<a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-call-get-access-token-finish" title="goa_oauth2_based_call_get_access_token_finish ()">goa_oauth2_based_call_get_access_token_finish</a> <span class="c_punctuation">()</span>
125
<td class="function_type">
126
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
128
<td class="function_name">
129
<a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-call-get-access-token-sync" title="goa_oauth2_based_call_get_access_token_sync ()">goa_oauth2_based_call_get_access_token_sync</a> <span class="c_punctuation">()</span>
133
<td class="function_type">
134
<span class="returnvalue">void</span>
136
<td class="function_name">
137
<a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-complete-get-access-token" title="goa_oauth2_based_complete_get_access_token ()">goa_oauth2_based_complete_get_access_token</a> <span class="c_punctuation">()</span>
141
<td class="function_type">
142
<span class="returnvalue">void</span>
144
<td class="function_name">
145
<a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new" title="goa_oauth2_based_proxy_new ()">goa_oauth2_based_proxy_new</a> <span class="c_punctuation">()</span>
149
<td class="function_type">
150
<a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="returnvalue">GoaOAuth2Based</span></a> *
152
<td class="function_name">
153
<a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-finish" title="goa_oauth2_based_proxy_new_finish ()">goa_oauth2_based_proxy_new_finish</a> <span class="c_punctuation">()</span>
157
<td class="function_type">
158
<a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="returnvalue">GoaOAuth2Based</span></a> *
160
<td class="function_name">
161
<a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-sync" title="goa_oauth2_based_proxy_new_sync ()">goa_oauth2_based_proxy_new_sync</a> <span class="c_punctuation">()</span>
165
<td class="function_type">
166
<span class="returnvalue">void</span>
168
<td class="function_name">
169
<a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-for-bus" title="goa_oauth2_based_proxy_new_for_bus ()">goa_oauth2_based_proxy_new_for_bus</a> <span class="c_punctuation">()</span>
173
<td class="function_type">
174
<a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="returnvalue">GoaOAuth2Based</span></a> *
176
<td class="function_name">
177
<a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-for-bus-finish" title="goa_oauth2_based_proxy_new_for_bus_finish ()">goa_oauth2_based_proxy_new_for_bus_finish</a> <span class="c_punctuation">()</span>
181
<td class="function_type">
182
<a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="returnvalue">GoaOAuth2Based</span></a> *
184
<td class="function_name">
185
<a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-for-bus-sync" title="goa_oauth2_based_proxy_new_for_bus_sync ()">goa_oauth2_based_proxy_new_for_bus_sync</a> <span class="c_punctuation">()</span>
189
<td class="function_type">
190
<a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="returnvalue">GoaOAuth2Based</span></a> *
192
<td class="function_name">
193
<a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-skeleton-new" title="goa_oauth2_based_skeleton_new ()">goa_oauth2_based_skeleton_new</a> <span class="c_punctuation">()</span>
199
<div class="refsect1">
200
<a name="GoaOAuth2Based.properties"></a><h2>Properties</h2>
201
<div class="informaltable"><table border="0">
203
<col width="150px" class="properties_type">
204
<col width="300px" class="properties_name">
205
<col width="200px" class="properties_flags">
209
<td class="property_type">
210
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
211
<td class="property_name"><a class="link" href="GoaOAuth2Based.html#GoaOAuth2Based--client-id" title="The “client-id” property">client-id</a></td>
212
<td class="property_flags">Read / Write</td>
215
<td class="property_type">
216
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
217
<td class="property_name"><a class="link" href="GoaOAuth2Based.html#GoaOAuth2Based--client-secret" title="The “client-secret” property">client-secret</a></td>
218
<td class="property_flags">Read / Write</td>
223
<div class="refsect1">
224
<a name="GoaOAuth2Based.signals"></a><h2>Signals</h2>
225
<div class="informaltable"><table border="0">
227
<col width="150px" class="signals_return">
228
<col width="300px" class="signals_name">
229
<col width="200px" class="signals_flags">
232
<td class="signal_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
233
<td class="signal_name"><a class="link" href="GoaOAuth2Based.html#GoaOAuth2Based-handle-get-access-token" title="The “handle-get-access-token” signal">handle-get-access-token</a></td>
234
<td class="signal_flags">Run Last</td>
238
<div class="refsect1">
239
<a name="GoaOAuth2Based.other"></a><h2>Types and Values</h2>
240
<div class="informaltable"><table width="100%" border="0">
242
<col width="150px" class="name">
243
<col class="description">
247
<td class="datatype_keyword"> </td>
248
<td class="function_name"><a class="link" href="GoaOAuth2Based.html#GoaOAuth2Based-struct" title="GoaOAuth2Based">GoaOAuth2Based</a></td>
251
<td class="datatype_keyword">struct</td>
252
<td class="function_name"><a class="link" href="GoaOAuth2Based.html#GoaOAuth2BasedIface" title="struct GoaOAuth2BasedIface">GoaOAuth2BasedIface</a></td>
255
<td class="datatype_keyword">struct</td>
256
<td class="function_name"><a class="link" href="GoaOAuth2Based.html#GoaOAuth2BasedProxy" title="struct GoaOAuth2BasedProxy">GoaOAuth2BasedProxy</a></td>
259
<td class="datatype_keyword">struct</td>
260
<td class="function_name"><a class="link" href="GoaOAuth2Based.html#GoaOAuth2BasedProxyClass" title="struct GoaOAuth2BasedProxyClass">GoaOAuth2BasedProxyClass</a></td>
263
<td class="datatype_keyword">struct</td>
264
<td class="function_name"><a class="link" href="GoaOAuth2Based.html#GoaOAuth2BasedSkeleton" title="struct GoaOAuth2BasedSkeleton">GoaOAuth2BasedSkeleton</a></td>
267
<td class="datatype_keyword">struct</td>
268
<td class="function_name"><a class="link" href="GoaOAuth2Based.html#GoaOAuth2BasedSkeletonClass" title="struct GoaOAuth2BasedSkeletonClass">GoaOAuth2BasedSkeletonClass</a></td>
123
273
<div class="refsect1">
124
274
<a name="GoaOAuth2Based.object-hierarchy"></a><h2>Object Hierarchy</h2>
125
<pre class="synopsis">
275
<pre class="screen"> GInterface
276
<span class="lineart">╰──</span> GoaOAuth2Based
130
279
<div class="refsect1">
131
280
<a name="GoaOAuth2Based.prerequisites"></a><h2>Prerequisites</h2>
133
282
GoaOAuth2Based requires
136
<div class="refsect1">
137
<a name="GoaOAuth2Based.properties"></a><h2>Properties</h2>
138
<pre class="synopsis">
139
"<a class="link" href="GoaOAuth2Based.html#GoaOAuth2Based--client-id" title='The "client-id" property'>client-id</a>" <span class="type">gchar</span>* : Read / Write
140
"<a class="link" href="GoaOAuth2Based.html#GoaOAuth2Based--client-secret" title='The "client-secret" property'>client-secret</a>" <span class="type">gchar</span>* : Read / Write
143
<div class="refsect1">
144
<a name="GoaOAuth2Based.signals"></a><h2>Signals</h2>
145
<pre class="synopsis">
146
"<a class="link" href="GoaOAuth2Based.html#GoaOAuth2Based-handle-get-access-token" title='The "handle-get-access-token" signal'>handle-get-access-token</a>" : <code class="literal">Run Last</code>
283
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>.</p>
149
285
<div class="refsect1">
150
286
<a name="GoaOAuth2Based.description"></a><h2>Description</h2>
152
This section contains code for working with the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-interface-org-gnome-OnlineAccounts-OAuth2Based.top_of_page">org.gnome.OnlineAccounts.OAuth2Based</a> D-Bus interface in C.
155
<div class="refsect1">
156
<a name="GoaOAuth2Based.details"></a><h2>Details</h2>
287
<p>This section contains code for working with the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-interface-org-gnome-OnlineAccounts-OAuth2Based.top_of_page">org.gnome.OnlineAccounts.OAuth2Based</a> D-Bus interface in C.</p>
289
<div class="refsect1">
290
<a name="GoaOAuth2Based.functions_details"></a><h2>Functions</h2>
291
<div class="refsect2">
292
<a name="goa-oauth2-based-interface-info"></a><h3>goa_oauth2_based_interface_info ()</h3>
293
<pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo"><span class="returnvalue">GDBusInterfaceInfo</span></a> *
294
goa_oauth2_based_interface_info (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
295
<p>Gets a machine-readable description of the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-interface-org-gnome-OnlineAccounts-OAuth2Based.top_of_page">org.gnome.OnlineAccounts.OAuth2Based</a> D-Bus interface.</p>
296
<div class="refsect3">
297
<a name="id-1.4.5.7.10.2.5"></a><h4>Returns</h4>
298
<p> A <a href="http://library.gnome.org/devel/gio/unstable/gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo"><span class="type">GDBusInterfaceInfo</span></a>. Do not free. </p>
299
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
303
<div class="refsect2">
304
<a name="goa-oauth2-based-override-properties"></a><h3>goa_oauth2_based_override_properties ()</h3>
305
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
306
goa_oauth2_based_override_properties (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *klass</code></em>,
307
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property_id_begin</code></em>);</pre>
308
<p>Overrides all <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> properties in the <a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> interface for a concrete class.
309
The properties are overridden in the order they are defined.</p>
310
<div class="refsect3">
311
<a name="id-1.4.5.7.10.3.5"></a><h4>Parameters</h4>
312
<div class="informaltable"><table width="100%" border="0">
314
<col width="150px" class="parameters_name">
315
<col class="parameters_description">
316
<col width="200px" class="parameters_annotations">
320
<td class="parameter_name"><p>klass</p></td>
321
<td class="parameter_description"><p>The class structure for a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>-derived class.</p></td>
322
<td class="parameter_annotations"> </td>
325
<td class="parameter_name"><p>property_id_begin</p></td>
326
<td class="parameter_description"><p>The property id to assign to the first overridden property.</p></td>
327
<td class="parameter_annotations"> </td>
332
<div class="refsect3">
333
<a name="id-1.4.5.7.10.3.6"></a><h4>Returns</h4>
334
<p> The last property id.</p>
339
<div class="refsect2">
340
<a name="goa-oauth2-based-get-client-id"></a><h3>goa_oauth2_based_get_client_id ()</h3>
341
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
342
goa_oauth2_based_get_client_id (<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *object</code></em>);</pre>
343
<p>Gets the value of the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-property-org-gnome-OnlineAccounts-OAuth2Based.ClientId" title='The "ClientId" property'>"ClientId"</a> D-Bus property.</p>
344
<p>Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.</p>
345
<div class="warning">The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where <em class="parameter"><code>object</code></em> was constructed. Use <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-dup-client-id" title="goa_oauth2_based_dup_client_id ()"><code class="function">goa_oauth2_based_dup_client_id()</code></a> if on another thread.</div>
346
<div class="refsect3">
347
<a name="id-1.4.5.7.10.4.7"></a><h4>Parameters</h4>
348
<div class="informaltable"><table width="100%" border="0">
350
<col width="150px" class="parameters_name">
351
<col class="parameters_description">
352
<col width="200px" class="parameters_annotations">
355
<td class="parameter_name"><p>object</p></td>
356
<td class="parameter_description"><p>A <a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a>.</p></td>
357
<td class="parameter_annotations"> </td>
361
<div class="refsect3">
362
<a name="id-1.4.5.7.10.4.8"></a><h4>Returns</h4>
363
<p> The property value or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the property is not set. Do not free the returned value, it belongs to <em class="parameter"><code>object</code></em>
365
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
369
<div class="refsect2">
370
<a name="goa-oauth2-based-set-client-id"></a><h3>goa_oauth2_based_set_client_id ()</h3>
371
<pre class="programlisting"><span class="returnvalue">void</span>
372
goa_oauth2_based_set_client_id (<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *object</code></em>,
373
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
374
<p>Sets the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-property-org-gnome-OnlineAccounts-OAuth2Based.ClientId" title='The "ClientId" property'>"ClientId"</a> D-Bus property to <em class="parameter"><code>value</code></em>
376
<p>Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.</p>
377
<div class="refsect3">
378
<a name="id-1.4.5.7.10.5.6"></a><h4>Parameters</h4>
379
<div class="informaltable"><table width="100%" border="0">
381
<col width="150px" class="parameters_name">
382
<col class="parameters_description">
383
<col width="200px" class="parameters_annotations">
387
<td class="parameter_name"><p>object</p></td>
388
<td class="parameter_description"><p>A <a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a>.</p></td>
389
<td class="parameter_annotations"> </td>
392
<td class="parameter_name"><p>value</p></td>
393
<td class="parameter_description"><p>The value to set.</p></td>
394
<td class="parameter_annotations"> </td>
401
<div class="refsect2">
402
<a name="goa-oauth2-based-dup-client-id"></a><h3>goa_oauth2_based_dup_client_id ()</h3>
403
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
404
goa_oauth2_based_dup_client_id (<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *object</code></em>);</pre>
405
<p>Gets a copy of the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-property-org-gnome-OnlineAccounts-OAuth2Based.ClientId" title='The "ClientId" property'>"ClientId"</a> D-Bus property.</p>
406
<p>Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.</p>
407
<div class="refsect3">
408
<a name="id-1.4.5.7.10.6.6"></a><h4>Parameters</h4>
409
<div class="informaltable"><table width="100%" border="0">
411
<col width="150px" class="parameters_name">
412
<col class="parameters_description">
413
<col width="200px" class="parameters_annotations">
416
<td class="parameter_name"><p>object</p></td>
417
<td class="parameter_description"><p>A <a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a>.</p></td>
418
<td class="parameter_annotations"> </td>
422
<div class="refsect3">
423
<a name="id-1.4.5.7.10.6.7"></a><h4>Returns</h4>
424
<p> The property value or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the property is not set. The returned value should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
425
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
429
<div class="refsect2">
430
<a name="goa-oauth2-based-get-client-secret"></a><h3>goa_oauth2_based_get_client_secret ()</h3>
431
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
432
goa_oauth2_based_get_client_secret (<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *object</code></em>);</pre>
433
<p>Gets the value of the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-property-org-gnome-OnlineAccounts-OAuth2Based.ClientSecret" title='The "ClientSecret" property'>"ClientSecret"</a> D-Bus property.</p>
434
<p>Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.</p>
435
<div class="warning">The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where <em class="parameter"><code>object</code></em> was constructed. Use <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-dup-client-secret" title="goa_oauth2_based_dup_client_secret ()"><code class="function">goa_oauth2_based_dup_client_secret()</code></a> if on another thread.</div>
436
<div class="refsect3">
437
<a name="id-1.4.5.7.10.7.7"></a><h4>Parameters</h4>
438
<div class="informaltable"><table width="100%" border="0">
440
<col width="150px" class="parameters_name">
441
<col class="parameters_description">
442
<col width="200px" class="parameters_annotations">
445
<td class="parameter_name"><p>object</p></td>
446
<td class="parameter_description"><p>A <a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a>.</p></td>
447
<td class="parameter_annotations"> </td>
451
<div class="refsect3">
452
<a name="id-1.4.5.7.10.7.8"></a><h4>Returns</h4>
453
<p> The property value or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the property is not set. Do not free the returned value, it belongs to <em class="parameter"><code>object</code></em>
455
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
459
<div class="refsect2">
460
<a name="goa-oauth2-based-set-client-secret"></a><h3>goa_oauth2_based_set_client_secret ()</h3>
461
<pre class="programlisting"><span class="returnvalue">void</span>
462
goa_oauth2_based_set_client_secret (<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *object</code></em>,
463
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
464
<p>Sets the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-property-org-gnome-OnlineAccounts-OAuth2Based.ClientSecret" title='The "ClientSecret" property'>"ClientSecret"</a> D-Bus property to <em class="parameter"><code>value</code></em>
466
<p>Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.</p>
467
<div class="refsect3">
468
<a name="id-1.4.5.7.10.8.6"></a><h4>Parameters</h4>
469
<div class="informaltable"><table width="100%" border="0">
471
<col width="150px" class="parameters_name">
472
<col class="parameters_description">
473
<col width="200px" class="parameters_annotations">
477
<td class="parameter_name"><p>object</p></td>
478
<td class="parameter_description"><p>A <a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a>.</p></td>
479
<td class="parameter_annotations"> </td>
482
<td class="parameter_name"><p>value</p></td>
483
<td class="parameter_description"><p>The value to set.</p></td>
484
<td class="parameter_annotations"> </td>
491
<div class="refsect2">
492
<a name="goa-oauth2-based-dup-client-secret"></a><h3>goa_oauth2_based_dup_client_secret ()</h3>
493
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
494
goa_oauth2_based_dup_client_secret (<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *object</code></em>);</pre>
495
<p>Gets a copy of the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-property-org-gnome-OnlineAccounts-OAuth2Based.ClientSecret" title='The "ClientSecret" property'>"ClientSecret"</a> D-Bus property.</p>
496
<p>Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.</p>
497
<div class="refsect3">
498
<a name="id-1.4.5.7.10.9.6"></a><h4>Parameters</h4>
499
<div class="informaltable"><table width="100%" border="0">
501
<col width="150px" class="parameters_name">
502
<col class="parameters_description">
503
<col width="200px" class="parameters_annotations">
506
<td class="parameter_name"><p>object</p></td>
507
<td class="parameter_description"><p>A <a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a>.</p></td>
508
<td class="parameter_annotations"> </td>
512
<div class="refsect3">
513
<a name="id-1.4.5.7.10.9.7"></a><h4>Returns</h4>
514
<p> The property value or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the property is not set. The returned value should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
515
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
519
<div class="refsect2">
520
<a name="goa-oauth2-based-call-get-access-token"></a><h3>goa_oauth2_based_call_get_access_token ()</h3>
521
<pre class="programlisting"><span class="returnvalue">void</span>
522
goa_oauth2_based_call_get_access_token
523
(<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *proxy</code></em>,
524
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
525
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
526
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
527
<p>Asynchronously invokes the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-method-org-gnome-OnlineAccounts-OAuth2Based.GetAccessToken" title="The GetAccessToken() method"><code class="function">GetAccessToken()</code></a> D-Bus method on <em class="parameter"><code>proxy</code></em>
529
When the operation is finished, <em class="parameter"><code>callback</code></em>
530
will be invoked in the <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main loop</a> of the thread you are calling this method from.
531
You can then call <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-call-get-access-token-finish" title="goa_oauth2_based_call_get_access_token_finish ()"><code class="function">goa_oauth2_based_call_get_access_token_finish()</code></a> to get the result of the operation.</p>
532
<p>See <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-call-get-access-token-sync" title="goa_oauth2_based_call_get_access_token_sync ()"><code class="function">goa_oauth2_based_call_get_access_token_sync()</code></a> for the synchronous, blocking version of this method.</p>
533
<div class="refsect3">
534
<a name="id-1.4.5.7.10.10.6"></a><h4>Parameters</h4>
535
<div class="informaltable"><table width="100%" border="0">
537
<col width="150px" class="parameters_name">
538
<col class="parameters_description">
539
<col width="200px" class="parameters_annotations">
543
<td class="parameter_name"><p>proxy</p></td>
544
<td class="parameter_description"><p>A <a class="link" href="GoaOAuth2Based.html#GoaOAuth2BasedProxy" title="struct GoaOAuth2BasedProxy"><span class="type">GoaOAuth2BasedProxy</span></a>.</p></td>
545
<td class="parameter_annotations"> </td>
548
<td class="parameter_name"><p>cancellable</p></td>
549
<td class="parameter_description"><p> A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
550
<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>
553
<td class="parameter_name"><p>callback</p></td>
554
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
555
<td class="parameter_annotations"> </td>
558
<td class="parameter_name"><p>user_data</p></td>
559
<td class="parameter_description"><p>User data to pass to <em class="parameter"><code>callback</code></em>
561
<td class="parameter_annotations"> </td>
568
<div class="refsect2">
569
<a name="goa-oauth2-based-call-get-access-token-finish"></a><h3>goa_oauth2_based_call_get_access_token_finish ()</h3>
570
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
571
goa_oauth2_based_call_get_access_token_finish
572
(<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *proxy</code></em>,
573
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **out_access_token</code></em>,
574
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *out_expires_in</code></em>,
575
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *res</code></em>,
576
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
577
<p>Finishes an operation started with <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-call-get-access-token" title="goa_oauth2_based_call_get_access_token ()"><code class="function">goa_oauth2_based_call_get_access_token()</code></a>.</p>
578
<div class="refsect3">
579
<a name="id-1.4.5.7.10.11.5"></a><h4>Parameters</h4>
580
<div class="informaltable"><table width="100%" border="0">
582
<col width="150px" class="parameters_name">
583
<col class="parameters_description">
584
<col width="200px" class="parameters_annotations">
588
<td class="parameter_name"><p>proxy</p></td>
589
<td class="parameter_description"><p>A <a class="link" href="GoaOAuth2Based.html#GoaOAuth2BasedProxy" title="struct GoaOAuth2BasedProxy"><span class="type">GoaOAuth2BasedProxy</span></a>.</p></td>
590
<td class="parameter_annotations"> </td>
593
<td class="parameter_name"><p>out_access_token</p></td>
594
<td class="parameter_description"><p> Return location for return parameter or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </p></td>
595
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
598
<td class="parameter_name"><p>out_expires_in</p></td>
599
<td class="parameter_description"><p> Return location for return parameter or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </p></td>
600
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
603
<td class="parameter_name"><p>res</p></td>
604
<td class="parameter_description"><p>The <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> obtained from the <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> passed to <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-call-get-access-token" title="goa_oauth2_based_call_get_access_token ()"><code class="function">goa_oauth2_based_call_get_access_token()</code></a>.</p></td>
605
<td class="parameter_annotations"> </td>
608
<td class="parameter_name"><p>error</p></td>
609
<td class="parameter_description"><p>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
610
<td class="parameter_annotations"> </td>
615
<div class="refsect3">
616
<a name="id-1.4.5.7.10.11.6"></a><h4>Returns</h4>
617
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the call succeded, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <em class="parameter"><code>error</code></em>
619
<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
623
<div class="refsect2">
624
<a name="goa-oauth2-based-call-get-access-token-sync"></a><h3>goa_oauth2_based_call_get_access_token_sync ()</h3>
625
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
626
goa_oauth2_based_call_get_access_token_sync
627
(<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *proxy</code></em>,
628
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **out_access_token</code></em>,
629
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *out_expires_in</code></em>,
630
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
631
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
632
<p>Synchronously invokes the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-method-org-gnome-OnlineAccounts-OAuth2Based.GetAccessToken" title="The GetAccessToken() method"><code class="function">GetAccessToken()</code></a> D-Bus method on <em class="parameter"><code>proxy</code></em>
633
. The calling thread is blocked until a reply is received.</p>
634
<p>See <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-call-get-access-token" title="goa_oauth2_based_call_get_access_token ()"><code class="function">goa_oauth2_based_call_get_access_token()</code></a> for the asynchronous version of this method.</p>
635
<div class="refsect3">
636
<a name="id-1.4.5.7.10.12.6"></a><h4>Parameters</h4>
637
<div class="informaltable"><table width="100%" border="0">
639
<col width="150px" class="parameters_name">
640
<col class="parameters_description">
641
<col width="200px" class="parameters_annotations">
645
<td class="parameter_name"><p>proxy</p></td>
646
<td class="parameter_description"><p>A <a class="link" href="GoaOAuth2Based.html#GoaOAuth2BasedProxy" title="struct GoaOAuth2BasedProxy"><span class="type">GoaOAuth2BasedProxy</span></a>.</p></td>
647
<td class="parameter_annotations"> </td>
650
<td class="parameter_name"><p>out_access_token</p></td>
651
<td class="parameter_description"><p> Return location for return parameter or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </p></td>
652
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
655
<td class="parameter_name"><p>out_expires_in</p></td>
656
<td class="parameter_description"><p> Return location for return parameter or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </p></td>
657
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
660
<td class="parameter_name"><p>cancellable</p></td>
661
<td class="parameter_description"><p> A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
662
<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>
665
<td class="parameter_name"><p>error</p></td>
666
<td class="parameter_description"><p>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
667
<td class="parameter_annotations"> </td>
672
<div class="refsect3">
673
<a name="id-1.4.5.7.10.12.7"></a><h4>Returns</h4>
674
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the call succeded, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <em class="parameter"><code>error</code></em>
676
<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
680
<div class="refsect2">
681
<a name="goa-oauth2-based-complete-get-access-token"></a><h3>goa_oauth2_based_complete_get_access_token ()</h3>
682
<pre class="programlisting"><span class="returnvalue">void</span>
683
goa_oauth2_based_complete_get_access_token
684
(<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *object</code></em>,
685
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusMethodInvocation.html"><span class="type">GDBusMethodInvocation</span></a> *invocation</code></em>,
686
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *access_token</code></em>,
687
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> expires_in</code></em>);</pre>
688
<p>Helper function used in service implementations to finish handling invocations of the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-method-org-gnome-OnlineAccounts-OAuth2Based.GetAccessToken" title="The GetAccessToken() method"><code class="function">GetAccessToken()</code></a> D-Bus method. If you instead want to finish handling an invocation by returning an error, use <a href="http://library.gnome.org/devel/gio/unstable/GDBusMethodInvocation.html#g-dbus-method-invocation-return-error"><code class="function">g_dbus_method_invocation_return_error()</code></a> or similar.</p>
689
<p>This method will free <em class="parameter"><code>invocation</code></em>
690
, you cannot use it afterwards.</p>
691
<div class="refsect3">
692
<a name="id-1.4.5.7.10.13.6"></a><h4>Parameters</h4>
693
<div class="informaltable"><table width="100%" border="0">
695
<col width="150px" class="parameters_name">
696
<col class="parameters_description">
697
<col width="200px" class="parameters_annotations">
701
<td class="parameter_name"><p>object</p></td>
702
<td class="parameter_description"><p>A <a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a>.</p></td>
703
<td class="parameter_annotations"> </td>
706
<td class="parameter_name"><p>invocation</p></td>
707
<td class="parameter_description"><p> A <a href="http://library.gnome.org/devel/gio/unstable/GDBusMethodInvocation.html"><span class="type">GDBusMethodInvocation</span></a>. </p></td>
708
<td class="parameter_annotations"><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
711
<td class="parameter_name"><p>access_token</p></td>
712
<td class="parameter_description"><p>Parameter to return.</p></td>
713
<td class="parameter_annotations"> </td>
716
<td class="parameter_name"><p>expires_in</p></td>
717
<td class="parameter_description"><p>Parameter to return.</p></td>
718
<td class="parameter_annotations"> </td>
725
<div class="refsect2">
726
<a name="goa-oauth2-based-proxy-new"></a><h3>goa_oauth2_based_proxy_new ()</h3>
727
<pre class="programlisting"><span class="returnvalue">void</span>
728
goa_oauth2_based_proxy_new (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a> *connection</code></em>,
729
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
730
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
731
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
732
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
733
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
734
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
735
<p>Asynchronously creates a proxy for the D-Bus interface <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-interface-org-gnome-OnlineAccounts-OAuth2Based.top_of_page">org.gnome.OnlineAccounts.OAuth2Based</a>. See <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#g-dbus-proxy-new"><code class="function">g_dbus_proxy_new()</code></a> for more details.</p>
736
<p>When the operation is finished, <em class="parameter"><code>callback</code></em>
737
will be invoked in the <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main loop</a> of the thread you are calling this method from.
738
You can then call <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-finish" title="goa_oauth2_based_proxy_new_finish ()"><code class="function">goa_oauth2_based_proxy_new_finish()</code></a> to get the result of the operation.</p>
739
<p>See <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-sync" title="goa_oauth2_based_proxy_new_sync ()"><code class="function">goa_oauth2_based_proxy_new_sync()</code></a> for the synchronous, blocking version of this constructor.</p>
740
<div class="refsect3">
741
<a name="id-1.4.5.7.10.14.7"></a><h4>Parameters</h4>
742
<div class="informaltable"><table width="100%" border="0">
744
<col width="150px" class="parameters_name">
745
<col class="parameters_description">
746
<col width="200px" class="parameters_annotations">
750
<td class="parameter_name"><p>connection</p></td>
751
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a>.</p></td>
752
<td class="parameter_annotations"> </td>
755
<td class="parameter_name"><p>flags</p></td>
756
<td class="parameter_description"><p>Flags from the <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</p></td>
757
<td class="parameter_annotations"> </td>
760
<td class="parameter_name"><p>name</p></td>
761
<td class="parameter_description"><p> A bus name (well-known or unique) or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>connection</code></em>
762
is not a message bus connection. </p></td>
763
<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>
766
<td class="parameter_name"><p>object_path</p></td>
767
<td class="parameter_description"><p>An object path.</p></td>
768
<td class="parameter_annotations"> </td>
771
<td class="parameter_name"><p>cancellable</p></td>
772
<td class="parameter_description"><p> A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
773
<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>
776
<td class="parameter_name"><p>callback</p></td>
777
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied.</p></td>
778
<td class="parameter_annotations"> </td>
781
<td class="parameter_name"><p>user_data</p></td>
782
<td class="parameter_description"><p>User data to pass to <em class="parameter"><code>callback</code></em>
784
<td class="parameter_annotations"> </td>
791
<div class="refsect2">
792
<a name="goa-oauth2-based-proxy-new-finish"></a><h3>goa_oauth2_based_proxy_new_finish ()</h3>
793
<pre class="programlisting"><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="returnvalue">GoaOAuth2Based</span></a> *
794
goa_oauth2_based_proxy_new_finish (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *res</code></em>,
795
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
796
<p>Finishes an operation started with <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new" title="goa_oauth2_based_proxy_new ()"><code class="function">goa_oauth2_based_proxy_new()</code></a>.</p>
797
<div class="refsect3">
798
<a name="id-1.4.5.7.10.15.5"></a><h4>Parameters</h4>
799
<div class="informaltable"><table width="100%" border="0">
801
<col width="150px" class="parameters_name">
802
<col class="parameters_description">
803
<col width="200px" class="parameters_annotations">
807
<td class="parameter_name"><p>res</p></td>
808
<td class="parameter_description"><p>The <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> obtained from the <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> passed to <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new" title="goa_oauth2_based_proxy_new ()"><code class="function">goa_oauth2_based_proxy_new()</code></a>.</p></td>
809
<td class="parameter_annotations"> </td>
812
<td class="parameter_name"><p>error</p></td>
813
<td class="parameter_description"><p>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
814
<td class="parameter_annotations"> </td>
819
<div class="refsect3">
820
<a name="id-1.4.5.7.10.15.6"></a><h4>Returns</h4>
821
<p> The constructed proxy object or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em>
823
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GoaOAuth2BasedProxy]</span></p>
827
<div class="refsect2">
828
<a name="goa-oauth2-based-proxy-new-sync"></a><h3>goa_oauth2_based_proxy_new_sync ()</h3>
829
<pre class="programlisting"><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="returnvalue">GoaOAuth2Based</span></a> *
830
goa_oauth2_based_proxy_new_sync (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a> *connection</code></em>,
831
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
832
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
833
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
834
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
835
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
836
<p>Synchronously creates a proxy for the D-Bus interface <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-interface-org-gnome-OnlineAccounts-OAuth2Based.top_of_page">org.gnome.OnlineAccounts.OAuth2Based</a>. See <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#g-dbus-proxy-new-sync"><code class="function">g_dbus_proxy_new_sync()</code></a> for more details.</p>
837
<p>The calling thread is blocked until a reply is received.</p>
838
<p>See <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new" title="goa_oauth2_based_proxy_new ()"><code class="function">goa_oauth2_based_proxy_new()</code></a> for the asynchronous version of this constructor.</p>
839
<div class="refsect3">
840
<a name="id-1.4.5.7.10.16.7"></a><h4>Parameters</h4>
841
<div class="informaltable"><table width="100%" border="0">
843
<col width="150px" class="parameters_name">
844
<col class="parameters_description">
845
<col width="200px" class="parameters_annotations">
849
<td class="parameter_name"><p>connection</p></td>
850
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a>.</p></td>
851
<td class="parameter_annotations"> </td>
854
<td class="parameter_name"><p>flags</p></td>
855
<td class="parameter_description"><p>Flags from the <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</p></td>
856
<td class="parameter_annotations"> </td>
859
<td class="parameter_name"><p>name</p></td>
860
<td class="parameter_description"><p> A bus name (well-known or unique) or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>connection</code></em>
861
is not a message bus connection. </p></td>
862
<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>
865
<td class="parameter_name"><p>object_path</p></td>
866
<td class="parameter_description"><p>An object path.</p></td>
867
<td class="parameter_annotations"> </td>
870
<td class="parameter_name"><p>cancellable</p></td>
871
<td class="parameter_description"><p> A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
872
<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>
875
<td class="parameter_name"><p>error</p></td>
876
<td class="parameter_description"><p>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
877
<td class="parameter_annotations"> </td>
882
<div class="refsect3">
883
<a name="id-1.4.5.7.10.16.8"></a><h4>Returns</h4>
884
<p> The constructed proxy object or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em>
886
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GoaOAuth2BasedProxy]</span></p>
890
<div class="refsect2">
891
<a name="goa-oauth2-based-proxy-new-for-bus"></a><h3>goa_oauth2_based_proxy_new_for_bus ()</h3>
892
<pre class="programlisting"><span class="returnvalue">void</span>
893
goa_oauth2_based_proxy_new_for_bus (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
894
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
895
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
896
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
897
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
898
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
899
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
900
<p>Like <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new" title="goa_oauth2_based_proxy_new ()"><code class="function">goa_oauth2_based_proxy_new()</code></a> but takes a <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a> instead of a <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a>.</p>
901
<p>When the operation is finished, <em class="parameter"><code>callback</code></em>
902
will be invoked in the <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main loop</a> of the thread you are calling this method from.
903
You can then call <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-for-bus-finish" title="goa_oauth2_based_proxy_new_for_bus_finish ()"><code class="function">goa_oauth2_based_proxy_new_for_bus_finish()</code></a> to get the result of the operation.</p>
904
<p>See <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-for-bus-sync" title="goa_oauth2_based_proxy_new_for_bus_sync ()"><code class="function">goa_oauth2_based_proxy_new_for_bus_sync()</code></a> for the synchronous, blocking version of this constructor.</p>
905
<div class="refsect3">
906
<a name="id-1.4.5.7.10.17.7"></a><h4>Parameters</h4>
907
<div class="informaltable"><table width="100%" border="0">
909
<col width="150px" class="parameters_name">
910
<col class="parameters_description">
911
<col width="200px" class="parameters_annotations">
915
<td class="parameter_name"><p>bus_type</p></td>
916
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a>.</p></td>
917
<td class="parameter_annotations"> </td>
920
<td class="parameter_name"><p>flags</p></td>
921
<td class="parameter_description"><p>Flags from the <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</p></td>
922
<td class="parameter_annotations"> </td>
925
<td class="parameter_name"><p>name</p></td>
926
<td class="parameter_description"><p>A bus name (well-known or unique).</p></td>
927
<td class="parameter_annotations"> </td>
930
<td class="parameter_name"><p>object_path</p></td>
931
<td class="parameter_description"><p>An object path.</p></td>
932
<td class="parameter_annotations"> </td>
935
<td class="parameter_name"><p>cancellable</p></td>
936
<td class="parameter_description"><p> A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
937
<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>
940
<td class="parameter_name"><p>callback</p></td>
941
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied.</p></td>
942
<td class="parameter_annotations"> </td>
945
<td class="parameter_name"><p>user_data</p></td>
946
<td class="parameter_description"><p>User data to pass to <em class="parameter"><code>callback</code></em>
948
<td class="parameter_annotations"> </td>
955
<div class="refsect2">
956
<a name="goa-oauth2-based-proxy-new-for-bus-finish"></a><h3>goa_oauth2_based_proxy_new_for_bus_finish ()</h3>
957
<pre class="programlisting"><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="returnvalue">GoaOAuth2Based</span></a> *
958
goa_oauth2_based_proxy_new_for_bus_finish
959
(<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *res</code></em>,
960
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
961
<p>Finishes an operation started with <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-for-bus" title="goa_oauth2_based_proxy_new_for_bus ()"><code class="function">goa_oauth2_based_proxy_new_for_bus()</code></a>.</p>
962
<div class="refsect3">
963
<a name="id-1.4.5.7.10.18.5"></a><h4>Parameters</h4>
964
<div class="informaltable"><table width="100%" border="0">
966
<col width="150px" class="parameters_name">
967
<col class="parameters_description">
968
<col width="200px" class="parameters_annotations">
972
<td class="parameter_name"><p>res</p></td>
973
<td class="parameter_description"><p>The <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> obtained from the <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> passed to <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-for-bus" title="goa_oauth2_based_proxy_new_for_bus ()"><code class="function">goa_oauth2_based_proxy_new_for_bus()</code></a>.</p></td>
974
<td class="parameter_annotations"> </td>
977
<td class="parameter_name"><p>error</p></td>
978
<td class="parameter_description"><p>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
979
<td class="parameter_annotations"> </td>
984
<div class="refsect3">
985
<a name="id-1.4.5.7.10.18.6"></a><h4>Returns</h4>
986
<p> The constructed proxy object or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em>
988
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GoaOAuth2BasedProxy]</span></p>
992
<div class="refsect2">
993
<a name="goa-oauth2-based-proxy-new-for-bus-sync"></a><h3>goa_oauth2_based_proxy_new_for_bus_sync ()</h3>
994
<pre class="programlisting"><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="returnvalue">GoaOAuth2Based</span></a> *
995
goa_oauth2_based_proxy_new_for_bus_sync
996
(<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
997
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
998
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
999
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
1000
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
1001
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1002
<p>Like <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-sync" title="goa_oauth2_based_proxy_new_sync ()"><code class="function">goa_oauth2_based_proxy_new_sync()</code></a> but takes a <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a> instead of a <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a>.</p>
1003
<p>The calling thread is blocked until a reply is received.</p>
1004
<p>See <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-for-bus" title="goa_oauth2_based_proxy_new_for_bus ()"><code class="function">goa_oauth2_based_proxy_new_for_bus()</code></a> for the asynchronous version of this constructor.</p>
1005
<div class="refsect3">
1006
<a name="id-1.4.5.7.10.19.7"></a><h4>Parameters</h4>
1007
<div class="informaltable"><table width="100%" border="0">
1009
<col width="150px" class="parameters_name">
1010
<col class="parameters_description">
1011
<col width="200px" class="parameters_annotations">
1015
<td class="parameter_name"><p>bus_type</p></td>
1016
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a>.</p></td>
1017
<td class="parameter_annotations"> </td>
1020
<td class="parameter_name"><p>flags</p></td>
1021
<td class="parameter_description"><p>Flags from the <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</p></td>
1022
<td class="parameter_annotations"> </td>
1025
<td class="parameter_name"><p>name</p></td>
1026
<td class="parameter_description"><p>A bus name (well-known or unique).</p></td>
1027
<td class="parameter_annotations"> </td>
1030
<td class="parameter_name"><p>object_path</p></td>
1031
<td class="parameter_description"><p>An object path.</p></td>
1032
<td class="parameter_annotations"> </td>
1035
<td class="parameter_name"><p>cancellable</p></td>
1036
<td class="parameter_description"><p> A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
1037
<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>
1040
<td class="parameter_name"><p>error</p></td>
1041
<td class="parameter_description"><p>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
1042
<td class="parameter_annotations"> </td>
1047
<div class="refsect3">
1048
<a name="id-1.4.5.7.10.19.8"></a><h4>Returns</h4>
1049
<p> The constructed proxy object or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em>
1051
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GoaOAuth2BasedProxy]</span></p>
1055
<div class="refsect2">
1056
<a name="goa-oauth2-based-skeleton-new"></a><h3>goa_oauth2_based_skeleton_new ()</h3>
1057
<pre class="programlisting"><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="returnvalue">GoaOAuth2Based</span></a> *
1058
goa_oauth2_based_skeleton_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1059
<p>Creates a skeleton object for the D-Bus interface <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-interface-org-gnome-OnlineAccounts-OAuth2Based.top_of_page">org.gnome.OnlineAccounts.OAuth2Based</a>.</p>
1060
<div class="refsect3">
1061
<a name="id-1.4.5.7.10.20.5"></a><h4>Returns</h4>
1062
<p> The skeleton object. </p>
1063
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GoaOAuth2BasedSkeleton]</span></p>
1067
<div class="refsect1">
1068
<a name="GoaOAuth2Based.other_details"></a><h2>Types and Values</h2>
157
1069
<div class="refsect2">
158
1070
<a name="GoaOAuth2Based-struct"></a><h3>GoaOAuth2Based</h3>
159
1071
<pre class="programlisting">typedef struct _GoaOAuth2Based GoaOAuth2Based;</pre>
161
Abstract interface type for the D-Bus interface <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-interface-org-gnome-OnlineAccounts-OAuth2Based.top_of_page">org.gnome.OnlineAccounts.OAuth2Based</a>.
1072
<p>Abstract interface type for the D-Bus interface <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-interface-org-gnome-OnlineAccounts-OAuth2Based.top_of_page">org.gnome.OnlineAccounts.OAuth2Based</a>.</p>
165
1075
<div class="refsect2">
177
1087
const gchar * (*get_client_secret) (GoaOAuth2Based *object);
181
Virtual table for the D-Bus interface <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-interface-org-gnome-OnlineAccounts-OAuth2Based.top_of_page">org.gnome.OnlineAccounts.OAuth2Based</a>.
183
<div class="variablelist"><table border="0" class="variablelist">
185
<col align="left" valign="top">
190
<td><p><span class="term"><span class="type">GTypeInterface</span> <em class="structfield"><code><a name="GoaOAuth2BasedIface.parent-iface"></a>parent_iface</code></em>;</span></p></td>
191
<td>The parent interface.</td>
194
<td><p><span class="term"><em class="structfield"><code><a name="GoaOAuth2BasedIface.handle-get-access-token"></a>handle_get_access_token</code></em> ()</span></p></td>
195
<td>Handler for the <a class="link" href="GoaOAuth2Based.html#GoaOAuth2Based-handle-get-access-token" title='The "handle-get-access-token" signal'><span class="type">"handle-get-access-token"</span></a> signal.</td>
198
<td><p><span class="term"><em class="structfield"><code><a name="GoaOAuth2BasedIface.get-client-id"></a>get_client_id</code></em> ()</span></p></td>
199
<td>Getter for the <a class="link" href="GoaOAuth2Based.html#GoaOAuth2Based--client-id" title='The "client-id" property'><span class="type">"client-id"</span></a> property.</td>
202
<td><p><span class="term"><em class="structfield"><code><a name="GoaOAuth2BasedIface.get-client-secret"></a>get_client_secret</code></em> ()</span></p></td>
203
<td>Getter for the <a class="link" href="GoaOAuth2Based.html#GoaOAuth2Based--client-secret" title='The "client-secret" property'><span class="type">"client-secret"</span></a> property.</td>
209
<div class="refsect2">
210
<a name="goa-oauth2-based-interface-info"></a><h3>goa_oauth2_based_interface_info ()</h3>
211
<pre class="programlisting"><span class="returnvalue">GDBusInterfaceInfo</span> * goa_oauth2_based_interface_info (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
213
Gets a machine-readable description of the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-interface-org-gnome-OnlineAccounts-OAuth2Based.top_of_page">org.gnome.OnlineAccounts.OAuth2Based</a> D-Bus interface.
215
<div class="variablelist"><table border="0" class="variablelist">
217
<col align="left" valign="top">
221
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
222
<td>A <span class="type">GDBusInterfaceInfo</span>. Do not free. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
228
<div class="refsect2">
229
<a name="goa-oauth2-based-override-properties"></a><h3>goa_oauth2_based_override_properties ()</h3>
230
<pre class="programlisting"><span class="returnvalue">guint</span> goa_oauth2_based_override_properties
231
(<em class="parameter"><code><span class="type">GObjectClass</span> *klass</code></em>,
232
<em class="parameter"><code><span class="type">guint</span> property_id_begin</code></em>);</pre>
234
Overrides all <span class="type">GObject</span> properties in the <a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> interface for a concrete class.
235
The properties are overridden in the order they are defined.
237
<div class="variablelist"><table border="0" class="variablelist">
239
<col align="left" valign="top">
244
<td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
245
<td>The class structure for a <span class="type">GObject</span>-derived class.</td>
248
<td><p><span class="term"><em class="parameter"><code>property_id_begin</code></em> :</span></p></td>
249
<td>The property id to assign to the first overridden property.</td>
252
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
253
<td>The last property id.</td>
259
<div class="refsect2">
260
<a name="goa-oauth2-based-get-client-id"></a><h3>goa_oauth2_based_get_client_id ()</h3>
261
<pre class="programlisting">const <span class="returnvalue">gchar</span> * goa_oauth2_based_get_client_id (<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *object</code></em>);</pre>
263
Gets the value of the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-property-org-gnome-OnlineAccounts-OAuth2Based.ClientId" title='The "ClientId" property'>"ClientId"</a> D-Bus property.
266
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
270
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
271
<h3 class="title">Warning</h3>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where <em class="parameter"><code>object</code></em> was constructed. Use <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-dup-client-id" title="goa_oauth2_based_dup_client_id ()"><code class="function">goa_oauth2_based_dup_client_id()</code></a> if on another thread.</div>
274
<div class="variablelist"><table border="0" class="variablelist">
276
<col align="left" valign="top">
281
<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
282
<td>A <a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a>.</td>
285
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
286
<td>The property value or <code class="literal">NULL</code> if the property is not set. Do not free the returned value, it belongs to <em class="parameter"><code>object</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
293
<div class="refsect2">
294
<a name="goa-oauth2-based-set-client-id"></a><h3>goa_oauth2_based_set_client_id ()</h3>
295
<pre class="programlisting"><span class="returnvalue">void</span> goa_oauth2_based_set_client_id (<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *object</code></em>,
296
<em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);</pre>
298
Sets the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-property-org-gnome-OnlineAccounts-OAuth2Based.ClientId" title='The "ClientId" property'>"ClientId"</a> D-Bus property to <em class="parameter"><code>value</code></em>.
301
Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
303
<div class="variablelist"><table border="0" class="variablelist">
305
<col align="left" valign="top">
310
<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
311
<td>A <a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a>.</td>
314
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
315
<td>The value to set.</td>
321
<div class="refsect2">
322
<a name="goa-oauth2-based-dup-client-id"></a><h3>goa_oauth2_based_dup_client_id ()</h3>
323
<pre class="programlisting"><span class="returnvalue">gchar</span> * goa_oauth2_based_dup_client_id (<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *object</code></em>);</pre>
325
Gets a copy of the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-property-org-gnome-OnlineAccounts-OAuth2Based.ClientId" title='The "ClientId" property'>"ClientId"</a> D-Bus property.
328
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
330
<div class="variablelist"><table border="0" class="variablelist">
332
<col align="left" valign="top">
337
<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
338
<td>A <a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a>.</td>
341
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
342
<td>The property value or <code class="literal">NULL</code> if the property is not set. The returned value should be freed with <code class="function">g_free()</code>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
349
<div class="refsect2">
350
<a name="goa-oauth2-based-get-client-secret"></a><h3>goa_oauth2_based_get_client_secret ()</h3>
351
<pre class="programlisting">const <span class="returnvalue">gchar</span> * goa_oauth2_based_get_client_secret (<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *object</code></em>);</pre>
353
Gets the value of the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-property-org-gnome-OnlineAccounts-OAuth2Based.ClientSecret" title='The "ClientSecret" property'>"ClientSecret"</a> D-Bus property.
356
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
360
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
361
<h3 class="title">Warning</h3>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where <em class="parameter"><code>object</code></em> was constructed. Use <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-dup-client-secret" title="goa_oauth2_based_dup_client_secret ()"><code class="function">goa_oauth2_based_dup_client_secret()</code></a> if on another thread.</div>
364
<div class="variablelist"><table border="0" class="variablelist">
366
<col align="left" valign="top">
371
<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
372
<td>A <a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a>.</td>
375
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
376
<td>The property value or <code class="literal">NULL</code> if the property is not set. Do not free the returned value, it belongs to <em class="parameter"><code>object</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
383
<div class="refsect2">
384
<a name="goa-oauth2-based-set-client-secret"></a><h3>goa_oauth2_based_set_client_secret ()</h3>
385
<pre class="programlisting"><span class="returnvalue">void</span> goa_oauth2_based_set_client_secret (<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *object</code></em>,
386
<em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);</pre>
388
Sets the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-property-org-gnome-OnlineAccounts-OAuth2Based.ClientSecret" title='The "ClientSecret" property'>"ClientSecret"</a> D-Bus property to <em class="parameter"><code>value</code></em>.
391
Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
393
<div class="variablelist"><table border="0" class="variablelist">
395
<col align="left" valign="top">
400
<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
401
<td>A <a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a>.</td>
404
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
405
<td>The value to set.</td>
411
<div class="refsect2">
412
<a name="goa-oauth2-based-dup-client-secret"></a><h3>goa_oauth2_based_dup_client_secret ()</h3>
413
<pre class="programlisting"><span class="returnvalue">gchar</span> * goa_oauth2_based_dup_client_secret (<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *object</code></em>);</pre>
415
Gets a copy of the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-property-org-gnome-OnlineAccounts-OAuth2Based.ClientSecret" title='The "ClientSecret" property'>"ClientSecret"</a> D-Bus property.
418
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
420
<div class="variablelist"><table border="0" class="variablelist">
422
<col align="left" valign="top">
427
<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
428
<td>A <a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a>.</td>
431
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
432
<td>The property value or <code class="literal">NULL</code> if the property is not set. The returned value should be freed with <code class="function">g_free()</code>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
439
<div class="refsect2">
440
<a name="goa-oauth2-based-call-get-access-token"></a><h3>goa_oauth2_based_call_get_access_token ()</h3>
441
<pre class="programlisting"><span class="returnvalue">void</span> goa_oauth2_based_call_get_access_token
442
(<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *proxy</code></em>,
443
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
444
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
445
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
447
Asynchronously invokes the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-method-org-gnome-OnlineAccounts-OAuth2Based.GetAccessToken" title="The GetAccessToken() method"><code class="function">GetAccessToken()</code></a> D-Bus method on <em class="parameter"><code>proxy</code></em>.
448
When the operation is finished, <em class="parameter"><code>callback</code></em> will be invoked in the thread-default main loop of the thread you are calling this method from.
449
You can then call <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-call-get-access-token-finish" title="goa_oauth2_based_call_get_access_token_finish ()"><code class="function">goa_oauth2_based_call_get_access_token_finish()</code></a> to get the result of the operation.
452
See <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-call-get-access-token-sync" title="goa_oauth2_based_call_get_access_token_sync ()"><code class="function">goa_oauth2_based_call_get_access_token_sync()</code></a> for the synchronous, blocking version of this method.
454
<div class="variablelist"><table border="0" class="variablelist">
456
<col align="left" valign="top">
461
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
462
<td>A <a class="link" href="GoaOAuth2Based.html#GoaOAuth2BasedProxy" title="struct GoaOAuth2BasedProxy"><span class="type">GoaOAuth2BasedProxy</span></a>.</td>
465
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
466
<td>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
470
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
471
<td>A <span class="type">GAsyncReadyCallback</span> to call when the request is satisfied or <code class="literal">NULL</code>.</td>
474
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
475
<td>User data to pass to <em class="parameter"><code>callback</code></em>.</td>
481
<div class="refsect2">
482
<a name="goa-oauth2-based-call-get-access-token-finish"></a><h3>goa_oauth2_based_call_get_access_token_finish ()</h3>
483
<pre class="programlisting"><span class="returnvalue">gboolean</span> goa_oauth2_based_call_get_access_token_finish
484
(<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *proxy</code></em>,
485
<em class="parameter"><code><span class="type">gchar</span> **out_access_token</code></em>,
486
<em class="parameter"><code><span class="type">gint</span> *out_expires_in</code></em>,
487
<em class="parameter"><code><span class="type">GAsyncResult</span> *res</code></em>,
488
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
490
Finishes an operation started with <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-call-get-access-token" title="goa_oauth2_based_call_get_access_token ()"><code class="function">goa_oauth2_based_call_get_access_token()</code></a>.
492
<div class="variablelist"><table border="0" class="variablelist">
494
<col align="left" valign="top">
499
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
500
<td>A <a class="link" href="GoaOAuth2Based.html#GoaOAuth2BasedProxy" title="struct GoaOAuth2BasedProxy"><span class="type">GoaOAuth2BasedProxy</span></a>.</td>
503
<td><p><span class="term"><em class="parameter"><code>out_access_token</code></em> :</span></p></td>
504
<td>Return location for return parameter or <code class="literal">NULL</code> to ignore. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
508
<td><p><span class="term"><em class="parameter"><code>out_expires_in</code></em> :</span></p></td>
509
<td>Return location for return parameter or <code class="literal">NULL</code> to ignore. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
513
<td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
514
<td>The <span class="type">GAsyncResult</span> obtained from the <span class="type">GAsyncReadyCallback</span> passed to <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-call-get-access-token" title="goa_oauth2_based_call_get_access_token ()"><code class="function">goa_oauth2_based_call_get_access_token()</code></a>.</td>
517
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
518
<td>Return location for error or <code class="literal">NULL</code>.</td>
521
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
523
<code class="literal">TRUE</code> if the call succeded, <code class="literal">FALSE</code> if <em class="parameter"><code>error</code></em> is set. <span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span>
530
<div class="refsect2">
531
<a name="goa-oauth2-based-call-get-access-token-sync"></a><h3>goa_oauth2_based_call_get_access_token_sync ()</h3>
532
<pre class="programlisting"><span class="returnvalue">gboolean</span> goa_oauth2_based_call_get_access_token_sync
533
(<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *proxy</code></em>,
534
<em class="parameter"><code><span class="type">gchar</span> **out_access_token</code></em>,
535
<em class="parameter"><code><span class="type">gint</span> *out_expires_in</code></em>,
536
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
537
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
539
Synchronously invokes the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-method-org-gnome-OnlineAccounts-OAuth2Based.GetAccessToken" title="The GetAccessToken() method"><code class="function">GetAccessToken()</code></a> D-Bus method on <em class="parameter"><code>proxy</code></em>. The calling thread is blocked until a reply is received.
542
See <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-call-get-access-token" title="goa_oauth2_based_call_get_access_token ()"><code class="function">goa_oauth2_based_call_get_access_token()</code></a> for the asynchronous version of this method.
544
<div class="variablelist"><table border="0" class="variablelist">
546
<col align="left" valign="top">
551
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
552
<td>A <a class="link" href="GoaOAuth2Based.html#GoaOAuth2BasedProxy" title="struct GoaOAuth2BasedProxy"><span class="type">GoaOAuth2BasedProxy</span></a>.</td>
555
<td><p><span class="term"><em class="parameter"><code>out_access_token</code></em> :</span></p></td>
556
<td>Return location for return parameter or <code class="literal">NULL</code> to ignore. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
560
<td><p><span class="term"><em class="parameter"><code>out_expires_in</code></em> :</span></p></td>
561
<td>Return location for return parameter or <code class="literal">NULL</code> to ignore. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
565
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
566
<td>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
570
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
571
<td>Return location for error or <code class="literal">NULL</code>.</td>
574
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
576
<code class="literal">TRUE</code> if the call succeded, <code class="literal">FALSE</code> if <em class="parameter"><code>error</code></em> is set. <span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span>
583
<div class="refsect2">
584
<a name="goa-oauth2-based-complete-get-access-token"></a><h3>goa_oauth2_based_complete_get_access_token ()</h3>
585
<pre class="programlisting"><span class="returnvalue">void</span> goa_oauth2_based_complete_get_access_token
586
(<em class="parameter"><code><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a> *object</code></em>,
587
<em class="parameter"><code><span class="type">GDBusMethodInvocation</span> *invocation</code></em>,
588
<em class="parameter"><code>const <span class="type">gchar</span> *access_token</code></em>,
589
<em class="parameter"><code><span class="type">gint</span> expires_in</code></em>);</pre>
591
Helper function used in service implementations to finish handling invocations of the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-method-org-gnome-OnlineAccounts-OAuth2Based.GetAccessToken" title="The GetAccessToken() method"><code class="function">GetAccessToken()</code></a> D-Bus method. If you instead want to finish handling an invocation by returning an error, use <code class="function">g_dbus_method_invocation_return_error()</code> or similar.
594
This method will free <em class="parameter"><code>invocation</code></em>, you cannot use it afterwards.
596
<div class="variablelist"><table border="0" class="variablelist">
598
<col align="left" valign="top">
603
<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
604
<td>A <a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="type">GoaOAuth2Based</span></a>.</td>
607
<td><p><span class="term"><em class="parameter"><code>invocation</code></em> :</span></p></td>
608
<td>A <span class="type">GDBusMethodInvocation</span>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
612
<td><p><span class="term"><em class="parameter"><code>access_token</code></em> :</span></p></td>
613
<td>Parameter to return.</td>
616
<td><p><span class="term"><em class="parameter"><code>expires_in</code></em> :</span></p></td>
617
<td>Parameter to return.</td>
1090
<p>Virtual table for the D-Bus interface <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-interface-org-gnome-OnlineAccounts-OAuth2Based.top_of_page">org.gnome.OnlineAccounts.OAuth2Based</a>.</p>
1091
<div class="refsect3">
1092
<a name="id-1.4.5.7.11.3.5"></a><h4>Members</h4>
1093
<div class="informaltable"><table width="100%" border="0">
1095
<col width="300px" class="struct_members_name">
1096
<col class="struct_members_description">
1097
<col width="200px" class="struct_members_annotations">
1101
<td class="struct_member_name"><p><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GTypeInterface"><span class="type">GTypeInterface</span></a> <em class="structfield"><code><a name="GoaOAuth2BasedIface.parent-iface"></a>parent_iface</code></em>;</p></td>
1102
<td class="struct_member_description"><p>The parent interface.</p></td>
1103
<td class="struct_member_annotations"> </td>
1106
<td class="struct_member_name"><p><em class="structfield"><code><a name="GoaOAuth2BasedIface.handle-get-access-token"></a>handle_get_access_token</code></em> ()</p></td>
1107
<td class="struct_member_description"><p>Handler for the <a class="link" href="GoaOAuth2Based.html#GoaOAuth2Based-handle-get-access-token" title="The “handle-get-access-token” signal"><span class="type">“handle-get-access-token”</span></a> signal.</p></td>
1108
<td class="struct_member_annotations"> </td>
1111
<td class="struct_member_name"><p><em class="structfield"><code><a name="GoaOAuth2BasedIface.get-client-id"></a>get_client_id</code></em> ()</p></td>
1112
<td class="struct_member_description"><p>Getter for the <a class="link" href="GoaOAuth2Based.html#GoaOAuth2Based--client-id" title="The “client-id” property"><span class="type">“client-id”</span></a> property.</p></td>
1113
<td class="struct_member_annotations"> </td>
1116
<td class="struct_member_name"><p><em class="structfield"><code><a name="GoaOAuth2BasedIface.get-client-secret"></a>get_client_secret</code></em> ()</p></td>
1117
<td class="struct_member_description"><p>Getter for the <a class="link" href="GoaOAuth2Based.html#GoaOAuth2Based--client-secret" title="The “client-secret” property"><span class="type">“client-secret”</span></a> property.</p></td>
1118
<td class="struct_member_annotations"> </td>
623
1125
<div class="refsect2">
636
1136
GDBusProxyClass parent_class;
640
Class structure for <a class="link" href="GoaOAuth2Based.html#GoaOAuth2BasedProxy" title="struct GoaOAuth2BasedProxy"><span class="type">GoaOAuth2BasedProxy</span></a>.
642
<div class="variablelist"><table border="0" class="variablelist">
1139
<p>Class structure for <a class="link" href="GoaOAuth2Based.html#GoaOAuth2BasedProxy" title="struct GoaOAuth2BasedProxy"><span class="type">GoaOAuth2BasedProxy</span></a>.</p>
1140
<div class="refsect3">
1141
<a name="id-1.4.5.7.11.5.5"></a><h4>Members</h4>
1142
<div class="informaltable"><table width="100%" border="0">
644
<col align="left" valign="top">
1144
<col width="300px" class="struct_members_name">
1145
<col class="struct_members_description">
1146
<col width="200px" class="struct_members_annotations">
648
<td><p><span class="term"><span class="type">GDBusProxyClass</span> <em class="structfield"><code><a name="GoaOAuth2BasedProxyClass.parent-class"></a>parent_class</code></em>;</span></p></td>
649
<td>The parent class.</td>
1149
<td class="struct_member_name"><p><a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyClass"><span class="type">GDBusProxyClass</span></a> <em class="structfield"><code><a name="GoaOAuth2BasedProxyClass.parent-class"></a>parent_class</code></em>;</p></td>
1150
<td class="struct_member_description"><p>The parent class.</p></td>
1151
<td class="struct_member_annotations"> </td>
654
<div class="refsect2">
655
<a name="goa-oauth2-based-proxy-new"></a><h3>goa_oauth2_based_proxy_new ()</h3>
656
<pre class="programlisting"><span class="returnvalue">void</span> goa_oauth2_based_proxy_new (<em class="parameter"><code><span class="type">GDBusConnection</span> *connection</code></em>,
657
<em class="parameter"><code><span class="type">GDBusProxyFlags</span> flags</code></em>,
658
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
659
<em class="parameter"><code>const <span class="type">gchar</span> *object_path</code></em>,
660
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
661
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
662
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
664
Asynchronously creates a proxy for the D-Bus interface <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-interface-org-gnome-OnlineAccounts-OAuth2Based.top_of_page">org.gnome.OnlineAccounts.OAuth2Based</a>. See <code class="function">g_dbus_proxy_new()</code> for more details.
667
When the operation is finished, <em class="parameter"><code>callback</code></em> will be invoked in the thread-default main loop of the thread you are calling this method from.
668
You can then call <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-finish" title="goa_oauth2_based_proxy_new_finish ()"><code class="function">goa_oauth2_based_proxy_new_finish()</code></a> to get the result of the operation.
671
See <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-sync" title="goa_oauth2_based_proxy_new_sync ()"><code class="function">goa_oauth2_based_proxy_new_sync()</code></a> for the synchronous, blocking version of this constructor.
673
<div class="variablelist"><table border="0" class="variablelist">
675
<col align="left" valign="top">
680
<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
681
<td>A <span class="type">GDBusConnection</span>.</td>
684
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
685
<td>Flags from the <span class="type">GDBusProxyFlags</span> enumeration.</td>
688
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
689
<td>A bus name (well-known or unique) or <code class="literal">NULL</code> if <em class="parameter"><code>connection</code></em> is not a message bus connection. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
693
<td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
694
<td>An object path.</td>
697
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
698
<td>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
702
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
703
<td>A <span class="type">GAsyncReadyCallback</span> to call when the request is satisfied.</td>
706
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
707
<td>User data to pass to <em class="parameter"><code>callback</code></em>.</td>
713
<div class="refsect2">
714
<a name="goa-oauth2-based-proxy-new-finish"></a><h3>goa_oauth2_based_proxy_new_finish ()</h3>
715
<pre class="programlisting"><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="returnvalue">GoaOAuth2Based</span></a> * goa_oauth2_based_proxy_new_finish (<em class="parameter"><code><span class="type">GAsyncResult</span> *res</code></em>,
716
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
718
Finishes an operation started with <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new" title="goa_oauth2_based_proxy_new ()"><code class="function">goa_oauth2_based_proxy_new()</code></a>.
720
<div class="variablelist"><table border="0" class="variablelist">
722
<col align="left" valign="top">
727
<td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
728
<td>The <span class="type">GAsyncResult</span> obtained from the <span class="type">GAsyncReadyCallback</span> passed to <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new" title="goa_oauth2_based_proxy_new ()"><code class="function">goa_oauth2_based_proxy_new()</code></a>.</td>
731
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
732
<td>Return location for error or <code class="literal">NULL</code>
736
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
737
<td>The constructed proxy object or <code class="literal">NULL</code> if <em class="parameter"><code>error</code></em> is set. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GoaOAuth2BasedProxy]</span>
744
<div class="refsect2">
745
<a name="goa-oauth2-based-proxy-new-sync"></a><h3>goa_oauth2_based_proxy_new_sync ()</h3>
746
<pre class="programlisting"><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="returnvalue">GoaOAuth2Based</span></a> * goa_oauth2_based_proxy_new_sync (<em class="parameter"><code><span class="type">GDBusConnection</span> *connection</code></em>,
747
<em class="parameter"><code><span class="type">GDBusProxyFlags</span> flags</code></em>,
748
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
749
<em class="parameter"><code>const <span class="type">gchar</span> *object_path</code></em>,
750
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
751
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
753
Synchronously creates a proxy for the D-Bus interface <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuth2Based.html#gdbus-interface-org-gnome-OnlineAccounts-OAuth2Based.top_of_page">org.gnome.OnlineAccounts.OAuth2Based</a>. See <code class="function">g_dbus_proxy_new_sync()</code> for more details.
756
The calling thread is blocked until a reply is received.
759
See <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new" title="goa_oauth2_based_proxy_new ()"><code class="function">goa_oauth2_based_proxy_new()</code></a> for the asynchronous version of this constructor.
761
<div class="variablelist"><table border="0" class="variablelist">
763
<col align="left" valign="top">
768
<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
769
<td>A <span class="type">GDBusConnection</span>.</td>
772
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
773
<td>Flags from the <span class="type">GDBusProxyFlags</span> enumeration.</td>
776
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
777
<td>A bus name (well-known or unique) or <code class="literal">NULL</code> if <em class="parameter"><code>connection</code></em> is not a message bus connection. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
781
<td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
782
<td>An object path.</td>
785
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
786
<td>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
790
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
791
<td>Return location for error or <code class="literal">NULL</code>
795
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
796
<td>The constructed proxy object or <code class="literal">NULL</code> if <em class="parameter"><code>error</code></em> is set. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GoaOAuth2BasedProxy]</span>
803
<div class="refsect2">
804
<a name="goa-oauth2-based-proxy-new-for-bus"></a><h3>goa_oauth2_based_proxy_new_for_bus ()</h3>
805
<pre class="programlisting"><span class="returnvalue">void</span> goa_oauth2_based_proxy_new_for_bus (<em class="parameter"><code><span class="type">GBusType</span> bus_type</code></em>,
806
<em class="parameter"><code><span class="type">GDBusProxyFlags</span> flags</code></em>,
807
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
808
<em class="parameter"><code>const <span class="type">gchar</span> *object_path</code></em>,
809
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
810
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
811
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
813
Like <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new" title="goa_oauth2_based_proxy_new ()"><code class="function">goa_oauth2_based_proxy_new()</code></a> but takes a <span class="type">GBusType</span> instead of a <span class="type">GDBusConnection</span>.
816
When the operation is finished, <em class="parameter"><code>callback</code></em> will be invoked in the thread-default main loop of the thread you are calling this method from.
817
You can then call <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-for-bus-finish" title="goa_oauth2_based_proxy_new_for_bus_finish ()"><code class="function">goa_oauth2_based_proxy_new_for_bus_finish()</code></a> to get the result of the operation.
820
See <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-for-bus-sync" title="goa_oauth2_based_proxy_new_for_bus_sync ()"><code class="function">goa_oauth2_based_proxy_new_for_bus_sync()</code></a> for the synchronous, blocking version of this constructor.
822
<div class="variablelist"><table border="0" class="variablelist">
824
<col align="left" valign="top">
829
<td><p><span class="term"><em class="parameter"><code>bus_type</code></em> :</span></p></td>
830
<td>A <span class="type">GBusType</span>.</td>
833
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
834
<td>Flags from the <span class="type">GDBusProxyFlags</span> enumeration.</td>
837
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
838
<td>A bus name (well-known or unique).</td>
841
<td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
842
<td>An object path.</td>
845
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
846
<td>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
850
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
851
<td>A <span class="type">GAsyncReadyCallback</span> to call when the request is satisfied.</td>
854
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
855
<td>User data to pass to <em class="parameter"><code>callback</code></em>.</td>
861
<div class="refsect2">
862
<a name="goa-oauth2-based-proxy-new-for-bus-finish"></a><h3>goa_oauth2_based_proxy_new_for_bus_finish ()</h3>
863
<pre class="programlisting"><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="returnvalue">GoaOAuth2Based</span></a> * goa_oauth2_based_proxy_new_for_bus_finish
864
(<em class="parameter"><code><span class="type">GAsyncResult</span> *res</code></em>,
865
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
867
Finishes an operation started with <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-for-bus" title="goa_oauth2_based_proxy_new_for_bus ()"><code class="function">goa_oauth2_based_proxy_new_for_bus()</code></a>.
869
<div class="variablelist"><table border="0" class="variablelist">
871
<col align="left" valign="top">
876
<td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
877
<td>The <span class="type">GAsyncResult</span> obtained from the <span class="type">GAsyncReadyCallback</span> passed to <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-for-bus" title="goa_oauth2_based_proxy_new_for_bus ()"><code class="function">goa_oauth2_based_proxy_new_for_bus()</code></a>.</td>
880
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
881
<td>Return location for error or <code class="literal">NULL</code>
885
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
886
<td>The constructed proxy object or <code class="literal">NULL</code> if <em class="parameter"><code>error</code></em> is set. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GoaOAuth2BasedProxy]</span>
893
<div class="refsect2">
894
<a name="goa-oauth2-based-proxy-new-for-bus-sync"></a><h3>goa_oauth2_based_proxy_new_for_bus_sync ()</h3>
895
<pre class="programlisting"><a class="link" href="GoaOAuth2Based.html" title="GoaOAuth2Based"><span class="returnvalue">GoaOAuth2Based</span></a> * goa_oauth2_based_proxy_new_for_bus_sync
896
(<em class="parameter"><code><span class="type">GBusType</span> bus_type</code></em>,
897
<em class="parameter"><code><span class="type">GDBusProxyFlags</span> flags</code></em>,
898
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
899
<em class="parameter"><code>const <span class="type">gchar</span> *object_path</code></em>,
900
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
901
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
903
Like <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-sync" title="goa_oauth2_based_proxy_new_sync ()"><code class="function">goa_oauth2_based_proxy_new_sync()</code></a> but takes a <span class="type">GBusType</span> instead of a <span class="type">GDBusConnection</span>.
906
The calling thread is blocked until a reply is received.
909
See <a class="link" href="GoaOAuth2Based.html#goa-oauth2-based-proxy-new-for-bus" title="goa_oauth2_based_proxy_new_for_bus ()"><code class="function">goa_oauth2_based_proxy_new_for_bus()</code></a> for the asynchronous version of this constructor.
911
<div class="variablelist"><table border="0" class="variablelist">
913
<col align="left" valign="top">
918
<td><p><span class="term"><em class="parameter"><code>bus_type</code></em> :</span></p></td>
919
<td>A <span class="type">GBusType</span>.</td>
922
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
923
<td>Flags from the <span class="type">GDBusProxyFlags</span> enumeration.</td>
926
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
927
<td>A bus name (well-known or unique).</td>
930
<td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
931
<td>An object path.</td>
934
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
935
<td>A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
939
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
940
<td>Return location for error or <code class="literal">NULL</code>
944
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
945
<td>The constructed proxy object or <code class="literal">NULL</code> if <em class="parameter"><code>error</code></em> is set. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GoaOAuth2BasedProxy]</span>
952
1157
<div class="refsect2">