~ubuntu-branches/ubuntu/oneiric/gnome-online-accounts/oneiric-proposed : revision 1

1

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

2

<html>

3

<head>

4

5

<title>GoaOAuthBased</title>

6

7

8

9

10

11

12

13

</head>

14

15

16

17

18

19

20

<th width="100%" align="center">GNOME Online Accounts Reference Manual</th>

21

22

</tr>

23

24

25

|

26

<a href="#GoaOAuthBased.description" class="shortcut">Description</a>

27

|

28

<a href="#GoaOAuthBased.object-hierarchy" class="shortcut">Object Hierarchy</a>

29

|

30

<a href="#GoaOAuthBased.prerequisites" class="shortcut">Prerequisites</a>

31

|

32

<a href="#GoaOAuthBased.properties" class="shortcut">Properties</a>

33

|

34

<a href="#GoaOAuthBased.signals" class="shortcut">Signals</a>

35

</td></tr>

36

</table>

37

38

39

40

41

<h2><a name="GoaOAuthBased.top_of_page"></a>GoaOAuthBased</h2>

42

GoaOAuthBased — Generated C code for the org.gnome.OnlineAccounts.OAuthBased D-Bus interface

43

</td>

44

45

</tr></table></div>

46

47

<a name="GoaOAuthBased.synopsis"></a><h2>Synopsis</h2>

48

<pre class="synopsis"> <a class="link" href="GoaOAuthBased.html#GoaOAuthBased-struct" title="GoaOAuthBased">GoaOAuthBased</a>;

49

struct <a class="link" href="GoaOAuthBased.html#GoaOAuthBasedIface" title="struct GoaOAuthBasedIface">GoaOAuthBasedIface</a>;

50

<a href="http://library.gnome.org/devel/gio/unstable/gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo">GDBusInterfaceInfo</a> * <a class="link" href="GoaOAuthBased.html#goa-oauth-based-interface-info" title="goa_oauth_based_interface_info ()">goa_oauth_based_interface_info</a> (<code>void</code>);

51

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> <a class="link" href="GoaOAuthBased.html#goa-oauth-based-override-properties" title="goa_oauth_based_override_properties ()">goa_oauth_based_override_properties</a> (<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass">GObjectClass</a> *klass</code>,

52

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

53

void <a class="link" href="GoaOAuthBased.html#goa-oauth-based-call-get-access-token" title="goa_oauth_based_call_get_access_token ()">goa_oauth_based_call_get_access_token</a>

54

(<code><a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> *proxy</code>,

55

<code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html">GCancellable</a> *cancellable</code>,

56

<code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> callback</code>,

57

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

58

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="GoaOAuthBased.html#goa-oauth-based-call-get-access-token-finish" title="goa_oauth_based_call_get_access_token_finish ()">goa_oauth_based_call_get_access_token_finish</a>

59

(<code><a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> *proxy</code>,

60

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

61

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

62

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

63

<code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html">GAsyncResult</a> *res</code>,

64

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);

65

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="GoaOAuthBased.html#goa-oauth-based-call-get-access-token-sync" title="goa_oauth_based_call_get_access_token_sync ()">goa_oauth_based_call_get_access_token_sync</a>

66

(<code><a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> *proxy</code>,

67

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

68

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

69

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

70

<code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html">GCancellable</a> *cancellable</code>,

71

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);

72

void <a class="link" href="GoaOAuthBased.html#goa-oauth-based-complete-get-access-token" title="goa_oauth_based_complete_get_access_token ()">goa_oauth_based_complete_get_access_token</a>

73

(<code><a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> *object</code>,

74

<code><a href="http://library.gnome.org/devel/gio/unstable/GDBusMethodInvocation.html">GDBusMethodInvocation</a> *invocation</code>,

75

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *access_token</code>,

76

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *access_token_secret</code>,

77

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

78

const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> * <a class="link" href="GoaOAuthBased.html#goa-oauth-based-get-consumer-key" title="goa_oauth_based_get_consumer_key ()">goa_oauth_based_get_consumer_key</a> (<code><a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> *object</code>);

79

void <a class="link" href="GoaOAuthBased.html#goa-oauth-based-set-consumer-key" title="goa_oauth_based_set_consumer_key ()">goa_oauth_based_set_consumer_key</a> (<code><a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> *object</code>,

80

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

81

const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> * <a class="link" href="GoaOAuthBased.html#goa-oauth-based-get-consumer-secret" title="goa_oauth_based_get_consumer_secret ()">goa_oauth_based_get_consumer_secret</a> (<code><a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> *object</code>);

82

void <a class="link" href="GoaOAuthBased.html#goa-oauth-based-set-consumer-secret" title="goa_oauth_based_set_consumer_secret ()">goa_oauth_based_set_consumer_secret</a> (<code><a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> *object</code>,

83

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

84

struct <a class="link" href="GoaOAuthBased.html#GoaOAuthBasedProxy" title="struct GoaOAuthBasedProxy">GoaOAuthBasedProxy</a>;

85

struct <a class="link" href="GoaOAuthBased.html#GoaOAuthBasedProxyClass" title="struct GoaOAuthBasedProxyClass">GoaOAuthBasedProxyClass</a>;

86

void <a class="link" href="GoaOAuthBased.html#goa-oauth-based-proxy-new" title="goa_oauth_based_proxy_new ()">goa_oauth_based_proxy_new</a> (<code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html">GDBusConnection</a> *connection</code>,

87

<code><a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags">GDBusProxyFlags</a> flags</code>,

88

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

89

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

90

<code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html">GCancellable</a> *cancellable</code>,

91

<code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> callback</code>,

92

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

93

<a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> * <a class="link" href="GoaOAuthBased.html#goa-oauth-based-proxy-new-finish" title="goa_oauth_based_proxy_new_finish ()">goa_oauth_based_proxy_new_finish</a> (<code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html">GAsyncResult</a> *res</code>,

94

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);

95

<a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> * <a class="link" href="GoaOAuthBased.html#goa-oauth-based-proxy-new-sync" title="goa_oauth_based_proxy_new_sync ()">goa_oauth_based_proxy_new_sync</a> (<code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html">GDBusConnection</a> *connection</code>,

96

<code><a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags">GDBusProxyFlags</a> flags</code>,

97

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

98

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

99

<code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html">GCancellable</a> *cancellable</code>,

100

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);

101

void <a class="link" href="GoaOAuthBased.html#goa-oauth-based-proxy-new-for-bus" title="goa_oauth_based_proxy_new_for_bus ()">goa_oauth_based_proxy_new_for_bus</a> (<code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType">GBusType</a> bus_type</code>,

102

<code><a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags">GDBusProxyFlags</a> flags</code>,

103

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

104

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

105

<code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html">GCancellable</a> *cancellable</code>,

106

<code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> callback</code>,

107

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

108

<a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> * <a class="link" href="GoaOAuthBased.html#goa-oauth-based-proxy-new-for-bus-finish" title="goa_oauth_based_proxy_new_for_bus_finish ()">goa_oauth_based_proxy_new_for_bus_finish</a>

109

(<code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html">GAsyncResult</a> *res</code>,

110

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);

111

<a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> * <a class="link" href="GoaOAuthBased.html#goa-oauth-based-proxy-new-for-bus-sync" title="goa_oauth_based_proxy_new_for_bus_sync ()">goa_oauth_based_proxy_new_for_bus_sync</a>

112

(<code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType">GBusType</a> bus_type</code>,

113

<code><a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags">GDBusProxyFlags</a> flags</code>,

114

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

115

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

116

<code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html">GCancellable</a> *cancellable</code>,

117

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);

118

struct <a class="link" href="GoaOAuthBased.html#GoaOAuthBasedSkeleton" title="struct GoaOAuthBasedSkeleton">GoaOAuthBasedSkeleton</a>;

119

struct <a class="link" href="GoaOAuthBased.html#GoaOAuthBasedSkeletonClass" title="struct GoaOAuthBasedSkeletonClass">GoaOAuthBasedSkeletonClass</a>;

120

<a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> * <a class="link" href="GoaOAuthBased.html#goa-oauth-based-skeleton-new" title="goa_oauth_based_skeleton_new ()">goa_oauth_based_skeleton_new</a> (<code>void</code>);

121

</pre>

122

</div>

123

124

<a name="GoaOAuthBased.object-hierarchy"></a><h2>Object Hierarchy</h2>

125

126

GInterface

127

+----GoaOAuthBased

128

</pre>

129

</div>

130

131

<a name="GoaOAuthBased.prerequisites"></a><h2>Prerequisites</h2>

132

133

GoaOAuthBased requires

134

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>.

135

</div>

136

137

<a name="GoaOAuthBased.properties"></a><h2>Properties</h2>

138

139

"<a class="link" href="GoaOAuthBased.html#GoaOAuthBased--consumer-key" title='The "consumer-key" property'>consumer-key</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a>* : Read / Write

140

"<a class="link" href="GoaOAuthBased.html#GoaOAuthBased--consumer-secret" title='The "consumer-secret" property'>consumer-secret</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a>* : Read / Write

141

</pre>

142

</div>

143

144

<a name="GoaOAuthBased.signals"></a><h2>Signals</h2>

145

146

"<a class="link" href="GoaOAuthBased.html#GoaOAuthBased-handle-get-access-token" title='The "handle-get-access-token" signal'>handle-get-access-token</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>

147

</pre>

148

</div>

149

150

<a name="GoaOAuthBased.description"></a><h2>Description</h2>

151

152

This section contains code for working with the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuthBased.html#gdbus-interface-org-gnome-OnlineAccounts-OAuthBased.top_of_page">org.gnome.OnlineAccounts.OAuthBased</a> D-Bus interface in C.

153

154

</div>

155

156

<a name="GoaOAuthBased.details"></a><h2>Details</h2>

157

158

<a name="GoaOAuthBased-struct"></a><h3>GoaOAuthBased</h3>

159

<pre class="programlisting">typedef struct _GoaOAuthBased GoaOAuthBased;</pre>

160

161

Abstract interface type for the D-Bus interface <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuthBased.html#gdbus-interface-org-gnome-OnlineAccounts-OAuthBased.top_of_page">org.gnome.OnlineAccounts.OAuthBased</a>.

162

163

</div>

164

<hr>

165

166

<a name="GoaOAuthBasedIface"></a><h3>struct GoaOAuthBasedIface</h3>

167

<pre class="programlisting">struct GoaOAuthBasedIface {

168

GTypeInterface parent_iface;

169

170

gboolean (*handle_get_access_token) (

171

GoaOAuthBased *object,

172

GDBusMethodInvocation *invocation);

173

};

174

</pre>

175

176

Virtual table for the D-Bus interface <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuthBased.html#gdbus-interface-org-gnome-OnlineAccounts-OAuthBased.top_of_page">org.gnome.OnlineAccounts.OAuthBased</a>.

177

178

179

180

<tbody>

181

<tr>

182

<td><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GTypeInterface">GTypeInterface</a> <code><a name="GoaOAuthBasedIface.parent-iface"></a>parent_iface</code>;</td>

183

<td>The parent interface.</td>

184

</tr>

185

<tr>

186

<td><code><a name="GoaOAuthBasedIface.handle-get-access-token"></a>handle_get_access_token</code> ()</td>

187

<td>Handler for the <a class="link" href="GoaOAuthBased.html#GoaOAuthBased-handle-get-access-token" title='The "handle-get-access-token" signal'>"handle-get-access-token"</a> signal.</td>

188

</tr>

189

</tbody>

190

</table></div>

191

</div>

192

<hr>

193

194

<a name="goa-oauth-based-interface-info"></a><h3>goa_oauth_based_interface_info ()</h3>

195

<pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo">GDBusInterfaceInfo</a> * goa_oauth_based_interface_info (<code>void</code>);</pre>

196

197

Gets a machine-readable description of the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuthBased.html#gdbus-interface-org-gnome-OnlineAccounts-OAuthBased.top_of_page">org.gnome.OnlineAccounts.OAuthBased</a> D-Bus interface.

198

199

200

201

202

<td>Returns :</td>

203

<td>A <a href="http://library.gnome.org/devel/gio/unstable/gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo">GDBusInterfaceInfo</a>. Do not free. [<a href="http://foldoc.org/transfer%20none">transfer none</a>]

204

</td>

205

</tr></tbody>

206

</table></div>

207

</div>

208

<hr>

209

210

<a name="goa-oauth-based-override-properties"></a><h3>goa_oauth_based_override_properties ()</h3>

211

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> goa_oauth_based_override_properties (<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass">GObjectClass</a> *klass</code>,

212

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

213

214

Overrides all <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> properties in the <a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> interface for a concrete class.

215

The properties are overridden in the order they are defined.

216

217

218

219

<tbody>

220

<tr>

221

<td><code>klass</code> :</td>

222

<td>The class structure for a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>-derived class.</td>

223

</tr>

224

<tr>

225

<td><code>property_id_begin</code> :</td>

226

<td>The property id to assign to the first overridden property.</td>

227

</tr>

228

<tr>

229

<td>Returns :</td>

230

<td>The last property id.</td>

231

</tr>

232

</tbody>

233

</table></div>

234

</div>

235

<hr>

236

237

<a name="goa-oauth-based-call-get-access-token"></a><h3>goa_oauth_based_call_get_access_token ()</h3>

238

<pre class="programlisting">void goa_oauth_based_call_get_access_token

239

(<code><a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> *proxy</code>,

240

<code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html">GCancellable</a> *cancellable</code>,

241

<code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> callback</code>,

242

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

243

244

Asynchronously invokes the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuthBased.html#gdbus-method-org-gnome-OnlineAccounts-OAuthBased.GetAccessToken" title="The GetAccessToken() method"><code class="function">GetAccessToken()</code></a> D-Bus method on <code>proxy</code>.

245

When the operation is finished, <code>callback</code> 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.

246

You can then call <a class="link" href="GoaOAuthBased.html#goa-oauth-based-call-get-access-token-finish" title="goa_oauth_based_call_get_access_token_finish ()"><code class="function">goa_oauth_based_call_get_access_token_finish()</code></a> to get the result of the operation.

247

248

249

See <a class="link" href="GoaOAuthBased.html#goa-oauth-based-call-get-access-token-sync" title="goa_oauth_based_call_get_access_token_sync ()"><code class="function">goa_oauth_based_call_get_access_token_sync()</code></a> for the synchronous, blocking version of this method.

250

251

252

253

<tbody>

254

<tr>

255

<td><code>proxy</code> :</td>

256

<td>A <a class="link" href="GoaOAuthBased.html#GoaOAuthBasedProxy" title="struct GoaOAuthBasedProxy">GoaOAuthBasedProxy</a>.</td>

257

</tr>

258

<tr>

259

<td><code>cancellable</code> :</td>

260

<td>A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html">GCancellable</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<a href="http://foldoc.org/allow-none">allow-none</a>]

261

</td>

262

</tr>

263

<tr>

264

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

265

<td>A <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</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>.</td>

266

</tr>

267

<tr>

268

269

<td>User data to pass to <code>callback</code>.</td>

270

</tr>

271

</tbody>

272

</table></div>

273

</div>

274

<hr>

275

276

<a name="goa-oauth-based-call-get-access-token-finish"></a><h3>goa_oauth_based_call_get_access_token_finish ()</h3>

277

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> goa_oauth_based_call_get_access_token_finish

278

(<code><a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> *proxy</code>,

279

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

280

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

281

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

282

<code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html">GAsyncResult</a> *res</code>,

283

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

284

285

Finishes an operation started with <a class="link" href="GoaOAuthBased.html#goa-oauth-based-call-get-access-token" title="goa_oauth_based_call_get_access_token ()"><code class="function">goa_oauth_based_call_get_access_token()</code></a>.

286

287

288

289

<tbody>

290

<tr>

291

<td><code>proxy</code> :</td>

292

<td>A <a class="link" href="GoaOAuthBased.html#GoaOAuthBasedProxy" title="struct GoaOAuthBasedProxy">GoaOAuthBasedProxy</a>.</td>

293

</tr>

294

<tr>

295

<td><code>out_access_token</code> :</td>

296

<td>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. [<a href="http://foldoc.org/out">out</a>]

297

</td>

298

</tr>

299

<tr>

300

<td><code>out_access_token_secret</code> :</td>

301

<td>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. [<a href="http://foldoc.org/out">out</a>]

302

</td>

303

</tr>

304

<tr>

305

<td><code>out_expires_in</code> :</td>

306

<td>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. [<a href="http://foldoc.org/out">out</a>]

307

</td>

308

</tr>

309

<tr>

310

311

<td>The <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html">GAsyncResult</a> obtained from the <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> passed to <a class="link" href="GoaOAuthBased.html#goa-oauth-based-call-get-access-token" title="goa_oauth_based_call_get_access_token ()"><code class="function">goa_oauth_based_call_get_access_token()</code></a>.</td>

312

</tr>

313

<tr>

314

<td><code>error</code> :</td>

315

<td>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>.</td>

316

</tr>

317

<tr>

318

<td>Returns :</td>

319

<td>

320

<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 <code>error</code> is set. [skip]

321

</td>

322

</tr>

323

</tbody>

324

</table></div>

325

</div>

326

<hr>

327

328

<a name="goa-oauth-based-call-get-access-token-sync"></a><h3>goa_oauth_based_call_get_access_token_sync ()</h3>

329

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> goa_oauth_based_call_get_access_token_sync

330

(<code><a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> *proxy</code>,

331

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

332

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

333

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

334

<code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html">GCancellable</a> *cancellable</code>,

335

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

336

337

Synchronously invokes the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuthBased.html#gdbus-method-org-gnome-OnlineAccounts-OAuthBased.GetAccessToken" title="The GetAccessToken() method"><code class="function">GetAccessToken()</code></a> D-Bus method on <code>proxy</code>. The calling thread is blocked until a reply is received.

338

339

340

See <a class="link" href="GoaOAuthBased.html#goa-oauth-based-call-get-access-token" title="goa_oauth_based_call_get_access_token ()"><code class="function">goa_oauth_based_call_get_access_token()</code></a> for the asynchronous version of this method.

341

342

343

344

<tbody>

345

<tr>

346

<td><code>proxy</code> :</td>

347

<td>A <a class="link" href="GoaOAuthBased.html#GoaOAuthBasedProxy" title="struct GoaOAuthBasedProxy">GoaOAuthBasedProxy</a>.</td>

348

</tr>

349

<tr>

350

<td><code>out_access_token</code> :</td>

351

<td>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. [<a href="http://foldoc.org/out">out</a>]

352

</td>

353

</tr>

354

<tr>

355

<td><code>out_access_token_secret</code> :</td>

356

<td>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. [<a href="http://foldoc.org/out">out</a>]

357

</td>

358

</tr>

359

<tr>

360

<td><code>out_expires_in</code> :</td>

361

<td>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. [<a href="http://foldoc.org/out">out</a>]

362

</td>

363

</tr>

364

<tr>

365

<td><code>cancellable</code> :</td>

366

<td>A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html">GCancellable</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<a href="http://foldoc.org/allow-none">allow-none</a>]

367

</td>

368

</tr>

369

<tr>

370

<td><code>error</code> :</td>

371

<td>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>.</td>

372

</tr>

373

<tr>

374

<td>Returns :</td>

375

<td>

376

<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 <code>error</code> is set. [skip]

377

</td>

378

</tr>

379

</tbody>

380

</table></div>

381

</div>

382

<hr>

383

384

<a name="goa-oauth-based-complete-get-access-token"></a><h3>goa_oauth_based_complete_get_access_token ()</h3>

385

<pre class="programlisting">void goa_oauth_based_complete_get_access_token

386

(<code><a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> *object</code>,

387

<code><a href="http://library.gnome.org/devel/gio/unstable/GDBusMethodInvocation.html">GDBusMethodInvocation</a> *invocation</code>,

388

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *access_token</code>,

389

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *access_token_secret</code>,

390

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

391

392

Helper function used in service implementations to finish handling invocations of the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuthBased.html#gdbus-method-org-gnome-OnlineAccounts-OAuthBased.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.

393

394

395

This method will free <code>invocation</code>, you cannot use it afterwards.

396

397

398

399

<tbody>

400

<tr>

401

<td><code>object</code> :</td>

402

<td>A <a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a>.</td>

403

</tr>

404

<tr>

405

<td><code>invocation</code> :</td>

406

<td>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusMethodInvocation.html">GDBusMethodInvocation</a>. [<a href="http://foldoc.org/transfer%20full">transfer full</a>]

407

</td>

408

</tr>

409

<tr>

410

<td><code>access_token</code> :</td>

411

<td>Parameter to return.</td>

412

</tr>

413

<tr>

414

<td><code>access_token_secret</code> :</td>

415

<td>Parameter to return.</td>

416

</tr>

417

<tr>

418

<td><code>expires_in</code> :</td>

419

<td>Parameter to return.</td>

420

</tr>

421

</tbody>

422

</table></div>

423

</div>

424

<hr>

425

426

<a name="goa-oauth-based-get-consumer-key"></a><h3>goa_oauth_based_get_consumer_key ()</h3>

427

<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> * goa_oauth_based_get_consumer_key (<code><a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> *object</code>);</pre>

428

429

Gets the value of the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuthBased.html#gdbus-property-org-gnome-OnlineAccounts-OAuthBased.ConsumerKey" title='The "ConsumerKey" property'>"ConsumerKey"</a> D-Bus property.

430

431

432

Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.

433

434

435

436

<tbody>

437

<tr>

438

<td><code>object</code> :</td>

439

<td>A <a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a>.</td>

440

</tr>

441

<tr>

442

<td>Returns :</td>

443

<td>The property value. [<a href="http://foldoc.org/transfer%20none">transfer none</a>]

444

</td>

445

</tr>

446

</tbody>

447

</table></div>

448

</div>

449

<hr>

450

451

<a name="goa-oauth-based-set-consumer-key"></a><h3>goa_oauth_based_set_consumer_key ()</h3>

452

<pre class="programlisting">void goa_oauth_based_set_consumer_key (<code><a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> *object</code>,

453

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

454

455

Sets the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuthBased.html#gdbus-property-org-gnome-OnlineAccounts-OAuthBased.ConsumerKey" title='The "ConsumerKey" property'>"ConsumerKey"</a> D-Bus property to <code>value</code>.

456

457

458

Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.

459

460

461

462

<tbody>

463

<tr>

464

<td><code>object</code> :</td>

465

<td>A <a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a>.</td>

466

</tr>

467

<tr>

468

<td><code>value</code> :</td>

469

<td>The value to set.</td>

470

</tr>

471

</tbody>

472

</table></div>

473

</div>

474

<hr>

475

476

<a name="goa-oauth-based-get-consumer-secret"></a><h3>goa_oauth_based_get_consumer_secret ()</h3>

477

<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> * goa_oauth_based_get_consumer_secret (<code><a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> *object</code>);</pre>

478

479

Gets the value of the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuthBased.html#gdbus-property-org-gnome-OnlineAccounts-OAuthBased.ConsumerSecret" title='The "ConsumerSecret" property'>"ConsumerSecret"</a> D-Bus property.

480

481

482

Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.

483

484

485

486

<tbody>

487

<tr>

488

<td><code>object</code> :</td>

489

<td>A <a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a>.</td>

490

</tr>

491

<tr>

492

<td>Returns :</td>

493

<td>The property value. [<a href="http://foldoc.org/transfer%20none">transfer none</a>]

494

</td>

495

</tr>

496

</tbody>

497

</table></div>

498

</div>

499

<hr>

500

501

<a name="goa-oauth-based-set-consumer-secret"></a><h3>goa_oauth_based_set_consumer_secret ()</h3>

502

<pre class="programlisting">void goa_oauth_based_set_consumer_secret (<code><a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> *object</code>,

503

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

504

505

Sets the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuthBased.html#gdbus-property-org-gnome-OnlineAccounts-OAuthBased.ConsumerSecret" title='The "ConsumerSecret" property'>"ConsumerSecret"</a> D-Bus property to <code>value</code>.

506

507

508

Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.

509

510

511

512

<tbody>

513

<tr>

514

<td><code>object</code> :</td>

515

<td>A <a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a>.</td>

516

</tr>

517

<tr>

518

<td><code>value</code> :</td>

519

<td>The value to set.</td>

520

</tr>

521

</tbody>

522

</table></div>

523

</div>

524

<hr>

525

526

<a name="GoaOAuthBasedProxy"></a><h3>struct GoaOAuthBasedProxy</h3>

527

<pre class="programlisting">struct GoaOAuthBasedProxy {

528

};

529

</pre>

530

531

The <a class="link" href="GoaOAuthBased.html#GoaOAuthBasedProxy" title="struct GoaOAuthBasedProxy">GoaOAuthBasedProxy</a> structure contains only private data and should only be accessed using the provided API.

532

533

</div>

534

<hr>

535

536

<a name="GoaOAuthBasedProxyClass"></a><h3>struct GoaOAuthBasedProxyClass</h3>

537

<pre class="programlisting">struct GoaOAuthBasedProxyClass {

538

GDBusProxyClass parent_class;

539

};

540

</pre>

541

542

Class structure for <a class="link" href="GoaOAuthBased.html#GoaOAuthBasedProxy" title="struct GoaOAuthBasedProxy">GoaOAuthBasedProxy</a>.

543

544

545

546

547

<td><a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyClass">GDBusProxyClass</a> <code><a name="GoaOAuthBasedProxyClass.parent-class"></a>parent_class</code>;</td>

548

<td>The parent class.</td>

549

</tr></tbody>

550

</table></div>

551

</div>

552

<hr>

553

554

<a name="goa-oauth-based-proxy-new"></a><h3>goa_oauth_based_proxy_new ()</h3>

555

<pre class="programlisting">void goa_oauth_based_proxy_new (<code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html">GDBusConnection</a> *connection</code>,

556

<code><a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags">GDBusProxyFlags</a> flags</code>,

557

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

558

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

559

<code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html">GCancellable</a> *cancellable</code>,

560

<code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> callback</code>,

561

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

562

563

Asynchronously creates a proxy for the D-Bus interface <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuthBased.html#gdbus-interface-org-gnome-OnlineAccounts-OAuthBased.top_of_page">org.gnome.OnlineAccounts.OAuthBased</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.

564

565

566

When the operation is finished, <code>callback</code> 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.

567

You can then call <a class="link" href="GoaOAuthBased.html#goa-oauth-based-proxy-new-finish" title="goa_oauth_based_proxy_new_finish ()"><code class="function">goa_oauth_based_proxy_new_finish()</code></a> to get the result of the operation.

568

569

570

See <a class="link" href="GoaOAuthBased.html#goa-oauth-based-proxy-new-sync" title="goa_oauth_based_proxy_new_sync ()"><code class="function">goa_oauth_based_proxy_new_sync()</code></a> for the synchronous, blocking version of this constructor.

571

572

573

574

<tbody>

575

<tr>

576

<td><code>connection</code> :</td>

577

<td>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html">GDBusConnection</a>.</td>

578

</tr>

579

<tr>

580

<td><code>flags</code> :</td>

581

<td>Flags from the <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags">GDBusProxyFlags</a> enumeration.</td>

582

</tr>

583

<tr>

584

585

<td>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 <code>connection</code> is not a message bus connection. [<a href="http://foldoc.org/allow-none">allow-none</a>]

586

</td>

587

</tr>

588

<tr>

589

<td><code>object_path</code> :</td>

590

<td>An object path.</td>

591

</tr>

592

<tr>

593

<td><code>cancellable</code> :</td>

594

<td>A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html">GCancellable</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<a href="http://foldoc.org/allow-none">allow-none</a>]

595

</td>

596

</tr>

597

<tr>

598

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

599

<td>A <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> to call when the request is satisfied.</td>

600

</tr>

601

<tr>

602

603

<td>User data to pass to <code>callback</code>.</td>

604

</tr>

605

</tbody>

606

</table></div>

607

</div>

608

<hr>

609

610

<a name="goa-oauth-based-proxy-new-finish"></a><h3>goa_oauth_based_proxy_new_finish ()</h3>

611

<pre class="programlisting"><a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> * goa_oauth_based_proxy_new_finish (<code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html">GAsyncResult</a> *res</code>,

612

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

613

614

Finishes an operation started with <a class="link" href="GoaOAuthBased.html#goa-oauth-based-proxy-new" title="goa_oauth_based_proxy_new ()"><code class="function">goa_oauth_based_proxy_new()</code></a>.

615

616

617

618

<tbody>

619

<tr>

620

621

<td>The <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html">GAsyncResult</a> obtained from the <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> passed to <a class="link" href="GoaOAuthBased.html#goa-oauth-based-proxy-new" title="goa_oauth_based_proxy_new ()"><code class="function">goa_oauth_based_proxy_new()</code></a>.</td>

622

</tr>

623

<tr>

624

<td><code>error</code> :</td>

625

<td>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>

626

</td>

627

</tr>

628

<tr>

629

<td>Returns :</td>

630

<td>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 <code>error</code> is set. [<a href="http://foldoc.org/transfer%20full">transfer full</a>][<a href="http://foldoc.org/type">type</a> GoaOAuthBasedProxy]

631

</td>

632

</tr>

633

</tbody>

634

</table></div>

635

</div>

636

<hr>

637

638

<a name="goa-oauth-based-proxy-new-sync"></a><h3>goa_oauth_based_proxy_new_sync ()</h3>

639

<pre class="programlisting"><a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> * goa_oauth_based_proxy_new_sync (<code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html">GDBusConnection</a> *connection</code>,

640

<code><a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags">GDBusProxyFlags</a> flags</code>,

641

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

642

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

643

<code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html">GCancellable</a> *cancellable</code>,

644

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

645

646

Synchronously creates a proxy for the D-Bus interface <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuthBased.html#gdbus-interface-org-gnome-OnlineAccounts-OAuthBased.top_of_page">org.gnome.OnlineAccounts.OAuthBased</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.

647

648

649

The calling thread is blocked until a reply is received.

650

651

652

See <a class="link" href="GoaOAuthBased.html#goa-oauth-based-proxy-new" title="goa_oauth_based_proxy_new ()"><code class="function">goa_oauth_based_proxy_new()</code></a> for the asynchronous version of this constructor.

653

654

655

656

<tbody>

657

<tr>

658

<td><code>connection</code> :</td>

659

<td>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html">GDBusConnection</a>.</td>

660

</tr>

661

<tr>

662

<td><code>flags</code> :</td>

663

<td>Flags from the <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags">GDBusProxyFlags</a> enumeration.</td>

664

</tr>

665

<tr>

666

667

<td>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 <code>connection</code> is not a message bus connection. [<a href="http://foldoc.org/allow-none">allow-none</a>]

668

</td>

669

</tr>

670

<tr>

671

<td><code>object_path</code> :</td>

672

<td>An object path.</td>

673

</tr>

674

<tr>

675

<td><code>cancellable</code> :</td>

676

<td>A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html">GCancellable</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<a href="http://foldoc.org/allow-none">allow-none</a>]

677

</td>

678

</tr>

679

<tr>

680

<td><code>error</code> :</td>

681

<td>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>

682

</td>

683

</tr>

684

<tr>

685

<td>Returns :</td>

686

<td>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 <code>error</code> is set. [<a href="http://foldoc.org/transfer%20full">transfer full</a>][<a href="http://foldoc.org/type">type</a> GoaOAuthBasedProxy]

687

</td>

688

</tr>

689

</tbody>

690

</table></div>

691

</div>

692

<hr>

693

694

<a name="goa-oauth-based-proxy-new-for-bus"></a><h3>goa_oauth_based_proxy_new_for_bus ()</h3>

695

<pre class="programlisting">void goa_oauth_based_proxy_new_for_bus (<code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType">GBusType</a> bus_type</code>,

696

<code><a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags">GDBusProxyFlags</a> flags</code>,

697

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

698

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

699

<code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html">GCancellable</a> *cancellable</code>,

700

<code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> callback</code>,

701

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

702

703

Like <a class="link" href="GoaOAuthBased.html#goa-oauth-based-proxy-new" title="goa_oauth_based_proxy_new ()"><code class="function">goa_oauth_based_proxy_new()</code></a> but takes a <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType">GBusType</a> instead of a <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html">GDBusConnection</a>.

704

705

706

When the operation is finished, <code>callback</code> 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.

707

You can then call <a class="link" href="GoaOAuthBased.html#goa-oauth-based-proxy-new-for-bus-finish" title="goa_oauth_based_proxy_new_for_bus_finish ()"><code class="function">goa_oauth_based_proxy_new_for_bus_finish()</code></a> to get the result of the operation.

708

709

710

See <a class="link" href="GoaOAuthBased.html#goa-oauth-based-proxy-new-for-bus-sync" title="goa_oauth_based_proxy_new_for_bus_sync ()"><code class="function">goa_oauth_based_proxy_new_for_bus_sync()</code></a> for the synchronous, blocking version of this constructor.

711

712

713

714

<tbody>

715

<tr>

716

717

<td>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType">GBusType</a>.</td>

718

</tr>

719

<tr>

720

<td><code>flags</code> :</td>

721

<td>Flags from the <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags">GDBusProxyFlags</a> enumeration.</td>

722

</tr>

723

<tr>

724

725

<td>A bus name (well-known or unique).</td>

726

</tr>

727

<tr>

728

<td><code>object_path</code> :</td>

729

<td>An object path.</td>

730

</tr>

731

<tr>

732

<td><code>cancellable</code> :</td>

733

<td>A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html">GCancellable</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<a href="http://foldoc.org/allow-none">allow-none</a>]

734

</td>

735

</tr>

736

<tr>

737

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

738

<td>A <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> to call when the request is satisfied.</td>

739

</tr>

740

<tr>

741

742

<td>User data to pass to <code>callback</code>.</td>

743

</tr>

744

</tbody>

745

</table></div>

746

</div>

747

<hr>

748

749

<a name="goa-oauth-based-proxy-new-for-bus-finish"></a><h3>goa_oauth_based_proxy_new_for_bus_finish ()</h3>

750

<pre class="programlisting"><a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> * goa_oauth_based_proxy_new_for_bus_finish

751

(<code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html">GAsyncResult</a> *res</code>,

752

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

753

754

Finishes an operation started with <a class="link" href="GoaOAuthBased.html#goa-oauth-based-proxy-new-for-bus" title="goa_oauth_based_proxy_new_for_bus ()"><code class="function">goa_oauth_based_proxy_new_for_bus()</code></a>.

755

756

757

758

<tbody>

759

<tr>

760

761

<td>The <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html">GAsyncResult</a> obtained from the <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> passed to <a class="link" href="GoaOAuthBased.html#goa-oauth-based-proxy-new-for-bus" title="goa_oauth_based_proxy_new_for_bus ()"><code class="function">goa_oauth_based_proxy_new_for_bus()</code></a>.</td>

762

</tr>

763

<tr>

764

<td><code>error</code> :</td>

765

<td>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>

766

</td>

767

</tr>

768

<tr>

769

<td>Returns :</td>

770

<td>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 <code>error</code> is set. [<a href="http://foldoc.org/transfer%20full">transfer full</a>][<a href="http://foldoc.org/type">type</a> GoaOAuthBasedProxy]

771

</td>

772

</tr>

773

</tbody>

774

</table></div>

775

</div>

776

<hr>

777

778

<a name="goa-oauth-based-proxy-new-for-bus-sync"></a><h3>goa_oauth_based_proxy_new_for_bus_sync ()</h3>

779

<pre class="programlisting"><a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> * goa_oauth_based_proxy_new_for_bus_sync

780

(<code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType">GBusType</a> bus_type</code>,

781

<code><a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags">GDBusProxyFlags</a> flags</code>,

782

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

783

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

784

<code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html">GCancellable</a> *cancellable</code>,

785

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

786

787

Like <a class="link" href="GoaOAuthBased.html#goa-oauth-based-proxy-new-sync" title="goa_oauth_based_proxy_new_sync ()"><code class="function">goa_oauth_based_proxy_new_sync()</code></a> but takes a <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType">GBusType</a> instead of a <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html">GDBusConnection</a>.

788

789

790

The calling thread is blocked until a reply is received.

791

792

793

See <a class="link" href="GoaOAuthBased.html#goa-oauth-based-proxy-new-for-bus" title="goa_oauth_based_proxy_new_for_bus ()"><code class="function">goa_oauth_based_proxy_new_for_bus()</code></a> for the asynchronous version of this constructor.

794

795

796

797

<tbody>

798

<tr>

799

800

<td>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType">GBusType</a>.</td>

801

</tr>

802

<tr>

803

<td><code>flags</code> :</td>

804

<td>Flags from the <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags">GDBusProxyFlags</a> enumeration.</td>

805

</tr>

806

<tr>

807

808

<td>A bus name (well-known or unique).</td>

809

</tr>

810

<tr>

811

<td><code>object_path</code> :</td>

812

<td>An object path.</td>

813

</tr>

814

<tr>

815

<td><code>cancellable</code> :</td>

816

<td>A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html">GCancellable</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<a href="http://foldoc.org/allow-none">allow-none</a>]

817

</td>

818

</tr>

819

<tr>

820

<td><code>error</code> :</td>

821

<td>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>

822

</td>

823

</tr>

824

<tr>

825

<td>Returns :</td>

826

<td>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 <code>error</code> is set. [<a href="http://foldoc.org/transfer%20full">transfer full</a>][<a href="http://foldoc.org/type">type</a> GoaOAuthBasedProxy]

827

</td>

828

</tr>

829

</tbody>

830

</table></div>

831

</div>

832

<hr>

833

834

<a name="GoaOAuthBasedSkeleton"></a><h3>struct GoaOAuthBasedSkeleton</h3>

835

<pre class="programlisting">struct GoaOAuthBasedSkeleton {

836

};

837

</pre>

838

839

The <a class="link" href="GoaOAuthBased.html#GoaOAuthBasedSkeleton" title="struct GoaOAuthBasedSkeleton">GoaOAuthBasedSkeleton</a> structure contains only private data and should only be accessed using the provided API.

840

841

</div>

842

<hr>

843

844

<a name="GoaOAuthBasedSkeletonClass"></a><h3>struct GoaOAuthBasedSkeletonClass</h3>

845

<pre class="programlisting">struct GoaOAuthBasedSkeletonClass {

846

GDBusInterfaceSkeletonClass parent_class;

847

};

848

</pre>

849

850

Class structure for <a class="link" href="GoaOAuthBased.html#GoaOAuthBasedSkeleton" title="struct GoaOAuthBasedSkeleton">GoaOAuthBasedSkeleton</a>.

851

852

853

854

855

<td><a href="http://library.gnome.org/devel/gio/unstable/GDBusInterfaceSkeleton.html#GDBusInterfaceSkeletonClass">GDBusInterfaceSkeletonClass</a> <code><a name="GoaOAuthBasedSkeletonClass.parent-class"></a>parent_class</code>;</td>

856

<td>The parent class.</td>

857

</tr></tbody>

858

</table></div>

859

</div>

860

<hr>

861

862

<a name="goa-oauth-based-skeleton-new"></a><h3>goa_oauth_based_skeleton_new ()</h3>

863

<pre class="programlisting"><a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> * goa_oauth_based_skeleton_new (<code>void</code>);</pre>

864

865

Creates a skeleton object for the D-Bus interface <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuthBased.html#gdbus-interface-org-gnome-OnlineAccounts-OAuthBased.top_of_page">org.gnome.OnlineAccounts.OAuthBased</a>.

866

867

868

869

870

<td>Returns :</td>

871

<td>The skeleton object. [<a href="http://foldoc.org/transfer%20full">transfer full</a>][<a href="http://foldoc.org/type">type</a> GoaOAuthBasedSkeleton]

872

</td>

873

</tr></tbody>

874

</table></div>

875

</div>

876

</div>

877

878

<a name="GoaOAuthBased.property-details"></a><h2>Property Details</h2>

879

880

<a name="GoaOAuthBased--consumer-key"></a><h3>The <code class="literal">"consumer-key"</code> property</h3>

881

<pre class="programlisting"> "consumer-key" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a>* : Read / Write</pre>

882

883

Represents the D-Bus property <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuthBased.html#gdbus-property-org-gnome-OnlineAccounts-OAuthBased.ConsumerKey" title='The "ConsumerKey" property'>"ConsumerKey"</a>.

884

885

886

Since the D-Bus property for this <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.

887

888

Default value: NULL

889

</div>

890

<hr>

891

892

<a name="GoaOAuthBased--consumer-secret"></a><h3>The <code class="literal">"consumer-secret"</code> property</h3>

893

<pre class="programlisting"> "consumer-secret" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a>* : Read / Write</pre>

894

895

Represents the D-Bus property <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuthBased.html#gdbus-property-org-gnome-OnlineAccounts-OAuthBased.ConsumerSecret" title='The "ConsumerSecret" property'>"ConsumerSecret"</a>.

896

897

898

Since the D-Bus property for this <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.

899

900

Default value: NULL

901

</div>

902

</div>

903

904

<a name="GoaOAuthBased.signal-details"></a><h2>Signal Details</h2>

905

906

<a name="GoaOAuthBased-handle-get-access-token"></a><h3>The <code class="literal">"handle-get-access-token"</code> signal</h3>

907

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> user_function (<a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a> *object,

908

<a href="http://library.gnome.org/devel/gio/unstable/GDBusMethodInvocation.html">GDBusMethodInvocation</a> *invocation,

909

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>

910

911

Signal emitted when a remote caller is invoking the <a class="link" href="gdbus-org.gnome.OnlineAccounts.OAuthBased.html#gdbus-method-org-gnome-OnlineAccounts-OAuthBased.GetAccessToken" title="The GetAccessToken() method"><code class="function">GetAccessToken()</code></a> D-Bus method.

912

913

914

If a signal handler returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, it means the signal handler will handle the invocation (e.g. take a reference to <code>invocation</code> and eventually call <a class="link" href="GoaOAuthBased.html#goa-oauth-based-complete-get-access-token" title="goa_oauth_based_complete_get_access_token ()"><code class="function">goa_oauth_based_complete_get_access_token()</code></a> or e.g. <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> on it) and no order signal handlers will run. If no signal handler handles the invocation, the <a href="http://library.gnome.org/devel/gio/unstable/GDBusError.html#G-DBUS-ERROR-UNKNOWN-METHOD:CAPS"><code class="literal">G_DBUS_ERROR_UNKNOWN_METHOD</code></a> error is returned.

915

916

917

918

<tbody>

919

<tr>

920

<td><code>object</code> :</td>

921

<td>A <a class="link" href="GoaOAuthBased.html" title="GoaOAuthBased">GoaOAuthBased</a>.</td>

922

</tr>

923

<tr>

924

<td><code>invocation</code> :</td>

925

<td>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusMethodInvocation.html">GDBusMethodInvocation</a>.</td>

926

</tr>

927

<tr>

928

929

<td>user data set when the signal handler was connected.</td>

930

</tr>

931

<tr>

932

<td>Returns :</td>

933

<td>

934

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the invocation was handled, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to let other signal handlers run.</td>

935

</tr>

936

</tbody>

937

</table></div>

938

</div>

939

</div>

940

</div>

941

942

<hr>

943

Generated by GTK-Doc V1.17</div>

944

</body>

945

</html>

b'\\ No newline at end of file'