~ubuntu-branches/ubuntu/precise/telepathy-glib/precise-201111172307

gboolean <a class="link" href="telepathy-glib-connection-simple-presence.html#tp-cli-connection-interface-simple-presence-run-get-presences" title="tp_cli_connection_interface_simple_presence_run_get_presences ()">tp_cli_connection_interface_simple_presence_run_get_presences</a>

(<code><a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy</code>,

<code>gint timeout_ms</code>,

<code>const GArray *in_Contacts</code>,

<code>GHashTable **out_Presence</code>,

<code>GError **error</code>,

<code>GMainLoop **loop</code>);

gboolean <a class="link" href="telepathy-glib-connection-simple-presence.html#tp-cli-connection-interface-simple-presence-run-set-presence" title="tp_cli_connection_interface_simple_presence_run_set_presence ()">tp_cli_connection_interface_simple_presence_run_set_presence</a>

(<code><a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy</code>,

<code>gint timeout_ms</code>,

<code>const gchar *in_Status</code>,

<code>const gchar *in_Status_Message</code>,

<code>GError **error</code>,

<code>GMainLoop **loop</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="telepathy-glib-connection-simple-presence.html#tp-cli-connection-interface-simple-presence-run-get-presences" title="tp_cli_connection_interface_simple_presence_run_get_presences ()">tp_cli_connection_interface_simple_presence_run_get_presences</a>

(<code><a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy</code>,

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

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray">GArray</a> *in_Contacts</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable">GHashTable</a> **out_Presence</code>,

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

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop">GMainLoop</a> **loop</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="telepathy-glib-connection-simple-presence.html#tp-cli-connection-interface-simple-presence-run-set-presence" title="tp_cli_connection_interface_simple_presence_run_set_presence ()">tp_cli_connection_interface_simple_presence_run_set_presence</a>

(<code><a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy</code>,

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

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

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

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

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop">GMainLoop</a> **loop</code>);

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-connection-simple-presence.html#tp-cli-connection-interface-simple-presence-call-get-presences" title="tp_cli_connection_interface_simple_presence_call_get_presences ()">tp_cli_connection_interface_simple_presence_call_get_presences</a>

(<code><a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy</code>,

<code>gint timeout_ms</code>,

<code>const GArray *in_Contacts</code>,

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

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray">GArray</a> *in_Contacts</code>,

<code><a class="link" href="telepathy-glib-connection-simple-presence.html#tp-cli-connection-interface-simple-presence-callback-for-get-presences" title="tp_cli_connection_interface_simple_presence_callback_for_get_presences ()">tp_cli_connection_interface_simple_presence_callback_for_get_presences</a> callback</code>,

<code>gpointer user_data</code>,

<code>GDestroyNotify destroy</code>,

<code>GObject *weak_object</code>);

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

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

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

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-connection-simple-presence.html#tp-cli-connection-interface-simple-presence-call-set-presence" title="tp_cli_connection_interface_simple_presence_call_set_presence ()">tp_cli_connection_interface_simple_presence_call_set_presence</a>

(<code><a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy</code>,

<code>gint timeout_ms</code>,

<code>const gchar *in_Status</code>,

<code>const gchar *in_Status_Message</code>,

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

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

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

<code><a class="link" href="telepathy-glib-connection-simple-presence.html#tp-cli-connection-interface-simple-presence-callback-for-set-presence" title="tp_cli_connection_interface_simple_presence_callback_for_set_presence ()">tp_cli_connection_interface_simple_presence_callback_for_set_presence</a> callback</code>,

<code>gpointer user_data</code>,

<code>GDestroyNotify destroy</code>,

<code>GObject *weak_object</code>);

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

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

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

void (<a class="link" href="telepathy-glib-connection-simple-presence.html#tp-cli-connection-interface-simple-presence-callback-for-get-presences" title="tp_cli_connection_interface_simple_presence_callback_for_get_presences ()">*tp_cli_connection_interface_simple_presence_callback_for_get_presences</a>)

(<code><a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy</code>,

<code>GHashTable *out_Presence</code>,

<code>const GError *error</code>,

<code>gpointer user_data</code>,

<code>GObject *weak_object</code>);

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable">GHashTable</a> *out_Presence</code>,

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

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

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

void (<a class="link" href="telepathy-glib-connection-simple-presence.html#tp-cli-connection-interface-simple-presence-callback-for-set-presence" title="tp_cli_connection_interface_simple_presence_callback_for_set_presence ()">*tp_cli_connection_interface_simple_presence_callback_for_set_presence</a>)

(<code><a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy</code>,

<code>const GError *error</code>,

<code>gpointer user_data</code>,

<code>GObject *weak_object</code>);

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

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

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

<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * <a class="link" href="telepathy-glib-connection-simple-presence.html#tp-cli-connection-interface-simple-presence-connect-to-presences-changed" title="tp_cli_connection_interface_simple_presence_connect_to_presences_changed ()">tp_cli_connection_interface_simple_presence_connect_to_presences_changed</a>

(<code><a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy</code>,

<code><a class="link" href="telepathy-glib-connection-simple-presence.html#tp-cli-connection-interface-simple-presence-signal-callback-presences-changed" title="tp_cli_connection_interface_simple_presence_signal_callback_presences_changed ()">tp_cli_connection_interface_simple_presence_signal_callback_presences_changed</a> callback</code>,

<code>gpointer user_data</code>,

<code>GDestroyNotify destroy</code>,

<code>GObject *weak_object</code>,

<code>GError **error</code>);

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

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

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

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

void (<a class="link" href="telepathy-glib-connection-simple-presence.html#tp-cli-connection-interface-simple-presence-signal-callback-presences-changed" title="tp_cli_connection_interface_simple_presence_signal_callback_presences_changed ()">*tp_cli_connection_interface_simple_presence_signal_callback_presences_changed</a>)

(<code><a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy</code>,

<code>GHashTable *arg_Presence</code>,

<code>gpointer user_data</code>,

<code>GObject *weak_object</code>);

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable">GHashTable</a> *arg_Presence</code>,

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

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

</pre>

</div>

113

<a name="telepathy-glib-connection-simple-presence.details"></a><h2>Details</h2>

114

115

<a name="tp-cli-connection-interface-simple-presence-run-get-presences"></a><h3>tp_cli_connection_interface_simple_presence_run_get_presences ()</h3>

116

<pre class="programlisting">gboolean tp_cli_connection_interface_simple_presence_run_get_presences

116

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

117

(<code><a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy</code>,

118

<code>gint timeout_ms</code>,

119

<code>const GArray *in_Contacts</code>,

120

<code>GHashTable **out_Presence</code>,

121

<code>GError **error</code>,

122

<code>GMainLoop **loop</code>);</pre>

118

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

119

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray">GArray</a> *in_Contacts</code>,

120

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable">GHashTable</a> **out_Presence</code>,

121

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

122

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop">GMainLoop</a> **loop</code>);</pre>

123

124

<h3 class="title">Warning</h3>

125

<code class="literal">tp_cli_connection_interface_simple_presence_run_get_presences</code> is deprecated and should not be used in newly-written code.

151

</tr>

152

<tr>

153

<td><code>out_Presence</code> :</td>

154

<td>Used to return an 'out' argument if <code class="literal">TRUE</code> is returned: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Presence information in the same format as for the <tp:member-ref>PresencesChanged</tp:member-ref> signal. The returned mapping MUST include an entry for each contact in the method's argument. The definition of the connection presence types Unknown and Offline means that if a connection manager will return Unknown for contacts not on the subscribe list, it MUST delay the reply to this method call until it has found out which contacts are, in fact, on the subscribe list.</td>

154

<td>Used to return an 'out' argument if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Presence information in the same format as for the <tp:member-ref>PresencesChanged</tp:member-ref> signal. The returned mapping MUST include an entry for each contact in the method's argument. The definition of the connection presence types Unknown and Offline means that if a connection manager will return Unknown for contacts not on the subscribe list, it MUST delay the reply to this method call until it has found out which contacts are, in fact, on the subscribe list.</td>

155

</tr>

156

<tr>

157

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

158

<td>If not <code class="literal">NULL</code>, used to return errors if <code class="literal">FALSE</code>

158

<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>

159

is returned</td>

160

</tr>

161

<tr>

162

163

<td>If not <code class="literal">NULL</code>, set before re-entering

164

the main loop, to point to a GMainLoop

163

<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering

164

the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop">GMainLoop</a>

165

which can be used to cancel this call with

166

<code class="function">g_main_loop_quit()</code>, causing a return of

167

<code class="literal">FALSE</code> with <code>error</code> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>

166

<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of

167

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <code>error</code> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>

168

</td>

169

</tr>

170

<tr>

177

<hr>

178

179

<a name="tp-cli-connection-interface-simple-presence-run-set-presence"></a><h3>tp_cli_connection_interface_simple_presence_run_set_presence ()</h3>

180

<pre class="programlisting">gboolean tp_cli_connection_interface_simple_presence_run_set_presence

180

181

(<code><a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy</code>,

182

<code>gint timeout_ms</code>,

183

<code>const gchar *in_Status</code>,

184

<code>const gchar *in_Status_Message</code>,

185

<code>GError **error</code>,

186

<code>GMainLoop **loop</code>);</pre>

182

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

183

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

184

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

185

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

186

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop">GMainLoop</a> **loop</code>);</pre>

187

188

<h3 class="title">Warning</h3>

189

<code class="literal">tp_cli_connection_interface_simple_presence_run_set_presence</code> is deprecated and should not be used in newly-written code.

219

</tr>

220

<tr>

221

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

222

<td>If not <code class="literal">NULL</code>, used to return errors if <code class="literal">FALSE</code>

222

223

is returned</td>

224

</tr>

225

<tr>

226

227

<td>If not <code class="literal">NULL</code>, set before re-entering

228

the main loop, to point to a GMainLoop

227

<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering

228

the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop">GMainLoop</a>

229

which can be used to cancel this call with

230

<code class="function">g_main_loop_quit()</code>, causing a return of

231

230

<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of

231

232

</td>

233

</tr>

234

<tr>

243

<a name="tp-cli-connection-interface-simple-presence-call-get-presences"></a><h3>tp_cli_connection_interface_simple_presence_call_get_presences ()</h3>

244

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_connection_interface_simple_presence_call_get_presences

245

(<code><a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy</code>,

246

<code>gint timeout_ms</code>,

247

<code>const GArray *in_Contacts</code>,

246

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

247

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray">GArray</a> *in_Contacts</code>,

248

249

<code>gpointer user_data</code>,

250

<code>GDestroyNotify destroy</code>,

251

<code>GObject *weak_object</code>);</pre>

249

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

250

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

251

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

252

253

Start a GetPresences method call.

254

275

<tr>

276

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

277

<td>called when the method call succeeds or fails;

278

may be <code class="literal">NULL</code> to make a "fire and forget" call with no

278

may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no

279

reply tracking</td>

280

</tr>

281

<tr>

282

283

<td>user-supplied data passed to the callback;

284

must be <code class="literal">NULL</code> if <code>callback</code> is <code class="literal">NULL</code>

284

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

285

</td>

286

</tr>

287

<tr>

288

<td><code>destroy</code> :</td>

289

<td>called with the user_data as argument, after the

290

call has succeeded, failed or been cancelled;

291

must be <code class="literal">NULL</code> if <code>callback</code> is <code class="literal">NULL</code>

291

292

</td>

293

</tr>

294

<tr>

295

<td><code>weak_object</code> :</td>

296

<td>If not <code class="literal">NULL</code>, a GObject which will be

296

<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be

297

weakly referenced; if it is destroyed, this call

298

will automatically be cancelled. Must be <code class="literal">NULL</code> if

299

<code>callback</code> is <code class="literal">NULL</code>

298

will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

299

<code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

300

</td>

301

</tr>

302

<tr>

314

<a name="tp-cli-connection-interface-simple-presence-call-set-presence"></a><h3>tp_cli_connection_interface_simple_presence_call_set_presence ()</h3>

315

316

(<code><a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy</code>,

317

<code>gint timeout_ms</code>,

318

<code>const gchar *in_Status</code>,

319

<code>const gchar *in_Status_Message</code>,

317

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

318

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

319

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

320

<code><a class="link" href="telepathy-glib-connection-simple-presence.html#tp-cli-connection-interface-simple-presence-callback-for-set-presence" title="tp_cli_connection_interface_simple_presence_callback_for_set_presence ()">tp_cli_connection_interface_simple_presence_callback_for_set_presence</a> callback</code>,

321

<code>gpointer user_data</code>,

322

<code>GDestroyNotify destroy</code>,

323

<code>GObject *weak_object</code>);</pre>

321

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

322

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

323

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

324

325

Start a SetPresence method call.

326

351

<tr>

352

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

353

<td>called when the method call succeeds or fails;

354

may be <code class="literal">NULL</code> to make a "fire and forget" call with no

354

may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no

355

reply tracking</td>

356

</tr>

357

<tr>

358

359

<td>user-supplied data passed to the callback;

360

must be <code class="literal">NULL</code> if <code>callback</code> is <code class="literal">NULL</code>

360

361

</td>

362

</tr>

363

<tr>

364

<td><code>destroy</code> :</td>

365

<td>called with the user_data as argument, after the

366

call has succeeded, failed or been cancelled;

367

must be <code class="literal">NULL</code> if <code>callback</code> is <code class="literal">NULL</code>

367

368

</td>

369

</tr>

370

<tr>

371

<td><code>weak_object</code> :</td>

372

<td>If not <code class="literal">NULL</code>, a GObject which will be

372

373

weakly referenced; if it is destroyed, this call

374

will automatically be cancelled. Must be <code class="literal">NULL</code> if

375

<code>callback</code> is <code class="literal">NULL</code>

374

will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

375

<code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

376

</td>

377

</tr>

378

<tr>

390

<a name="tp-cli-connection-interface-simple-presence-callback-for-get-presences"></a><h3>tp_cli_connection_interface_simple_presence_callback_for_get_presences ()</h3>

391

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

392

(<code><a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy</code>,

393

<code>GHashTable *out_Presence</code>,

394

<code>const GError *error</code>,

395

<code>gpointer user_data</code>,

396

<code>GObject *weak_object</code>);</pre>

393

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable">GHashTable</a> *out_Presence</code>,

394

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

395

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

396

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

397

398

Signature of the callback called when a GetPresences method call

399

succeeds or fails.

407

</tr>

408

<tr>

409

<td><code>out_Presence</code> :</td>

410

<td>Used to return an 'out' argument if <code>error</code> is <code class="literal">NULL</code>: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Presence information in the same format as for the <tp:member-ref>PresencesChanged</tp:member-ref> signal. The returned mapping MUST include an entry for each contact in the method's argument. The definition of the connection presence types Unknown and Offline means that if a connection manager will return Unknown for contacts not on the subscribe list, it MUST delay the reply to this method call until it has found out which contacts are, in fact, on the subscribe list.</td>

410

<td>Used to return an 'out' argument if <code>error</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Presence information in the same format as for the <tp:member-ref>PresencesChanged</tp:member-ref> signal. The returned mapping MUST include an entry for each contact in the method's argument. The definition of the connection presence types Unknown and Offline means that if a connection manager will return Unknown for contacts not on the subscribe list, it MUST delay the reply to this method call until it has found out which contacts are, in fact, on the subscribe list.</td>

411

</tr>

412

<tr>

413

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

414

<td>

415

<code class="literal">NULL</code> on success, or an error on failure</td>

415

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>

416

</tr>

417

<tr>

418

430

<a name="tp-cli-connection-interface-simple-presence-callback-for-set-presence"></a><h3>tp_cli_connection_interface_simple_presence_callback_for_set_presence ()</h3>

431

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

432

(<code><a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy</code>,

433

<code>const GError *error</code>,

434

<code>gpointer user_data</code>,

435

<code>GObject *weak_object</code>);</pre>

433

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

434

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

435

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

436

437

Signature of the callback called when a SetPresence method call

438

succeeds or fails.

447

<tr>

448

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

449

<td>

450

<code class="literal">NULL</code> on success, or an error on failure</td>

450

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>

451

</tr>

452

<tr>

453

466

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * tp_cli_connection_interface_simple_presence_connect_to_presences_changed

467

(<code><a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy</code>,

468

469

<code>gpointer user_data</code>,

470

<code>GDestroyNotify destroy</code>,

471

<code>GObject *weak_object</code>,

472

<code>GError **error</code>);</pre>

469

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

470

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

471

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

472

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

473

474

Connect a handler to the signal PresencesChanged.

475

496

<td><code>destroy</code> :</td>

497

<td>Destructor for the user-supplied data, which

498

will be called when this signal is disconnected, or

499

before this function returns <code class="literal">NULL</code>

499

before this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

500

</td>

501

</tr>

502

<tr>

503

<td><code>weak_object</code> :</td>

504

<td>A GObject which will be weakly referenced;

504

<td>A <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be weakly referenced;

505

if it is destroyed, this callback will automatically be

506

disconnected</td>

507

</tr>

508

<tr>

509

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

510

<td>If not <code class="literal">NULL</code>, used to raise an error if <code class="literal">NULL</code> is

510

<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is

511

returned</td>

512

</tr>

513

<tr>

514

<td>Returns :</td>

515

<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> containing all of the

516

above, which can be used to disconnect the signal; or

517

<code class="literal">NULL</code> if the proxy does not have the desired interface

517

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the proxy does not have the desired interface

518

or has become invalid.</td>

519

</tr>

520

</tbody>

525

<a name="tp-cli-connection-interface-simple-presence-signal-callback-presences-changed"></a><h3>tp_cli_connection_interface_simple_presence_signal_callback_presences_changed ()</h3>

526

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

527

(<code><a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy</code>,

528

<code>GHashTable *arg_Presence</code>,

529

<code>gpointer user_data</code>,

530

<code>GObject *weak_object</code>);</pre>

528

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable">GHashTable</a> *arg_Presence</code>,

529

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

530

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

531

532

Represents the signature of a callback for the signal PresencesChanged.

533

562

</div>

563

564

<hr>

565

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

565

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

566

</body>

567

</html>

b'\\ No newline at end of file'

Older »