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

GPtrArray * <a class="link" href="telepathy-glib-capabilities.html#tp-capabilities-get-channel-classes" title="tp_capabilities_get_channel_classes ()">tp_capabilities_get_channel_classes</a> (<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>);

gboolean <a class="link" href="telepathy-glib-capabilities.html#tp-capabilities-is-specific-to-contact" title="tp_capabilities_is_specific_to_contact ()">tp_capabilities_is_specific_to_contact</a>

(<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>);

gboolean <a class="link" href="telepathy-glib-capabilities.html#tp-capabilities-supports-text-chatrooms" title="tp_capabilities_supports_text_chatrooms ()">tp_capabilities_supports_text_chatrooms</a>

(<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>);

gboolean <a class="link" href="telepathy-glib-capabilities.html#tp-capabilities-supports-text-chats" title="tp_capabilities_supports_text_chats ()">tp_capabilities_supports_text_chats</a> (<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>);

gboolean <a class="link" href="telepathy-glib-capabilities.html#tp-capabilities-supports-stream-tubes" title="tp_capabilities_supports_stream_tubes ()">tp_capabilities_supports_stream_tubes</a>

(<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>,

<code><a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType">TpHandleType</a> handle_type</code>,

<code>const gchar *service</code>);

gboolean <a class="link" href="telepathy-glib-capabilities.html#tp-capabilities-supports-dbus-tubes" title="tp_capabilities_supports_dbus_tubes ()">tp_capabilities_supports_dbus_tubes</a> (<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>,

<code><a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType">TpHandleType</a> handle_type</code>,

<code>const gchar *service_name</code>);

gboolean <a class="link" href="telepathy-glib-capabilities.html#tp-capabilities-supports-contact-search" title="tp_capabilities_supports_contact_search ()">tp_capabilities_supports_contact_search</a>

(<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>,

<code>gboolean *with_limit</code>,

<code>gboolean *with_server</code>);

gboolean <a class="link" href="telepathy-glib-capabilities.html#tp-capabilities-supports-room-list" title="tp_capabilities_supports_room_list ()">tp_capabilities_supports_room_list</a> (<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>,

<code>gboolean *with_server</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> * <a class="link" href="telepathy-glib-capabilities.html#tp-capabilities-get-channel-classes" title="tp_capabilities_get_channel_classes ()">tp_capabilities_get_channel_classes</a> (<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>);

(<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="telepathy-glib-capabilities.html#tp-capabilities-supports-text-chats" title="tp_capabilities_supports_text_chats ()">tp_capabilities_supports_text_chats</a> (<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>);

(<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>,

<code><a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType">TpHandleType</a> handle_type</code>,

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

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="telepathy-glib-capabilities.html#tp-capabilities-supports-dbus-tubes" title="tp_capabilities_supports_dbus_tubes ()">tp_capabilities_supports_dbus_tubes</a> (<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>,

<code><a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType">TpHandleType</a> handle_type</code>,

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

(<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>,

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

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

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="telepathy-glib-capabilities.html#tp-capabilities-supports-room-list" title="tp_capabilities_supports_room_list ()">tp_capabilities_supports_room_list</a> (<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>,

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

</pre>

</div>

<a name="telepathy-glib-capabilities.object-hierarchy"></a><h2>Object Hierarchy</h2>

GObject

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

+----TpCapabilities

</pre>

</div>

<a name="telepathy-glib-capabilities.properties"></a><h2>Properties</h2>

"<a class="link" href="telepathy-glib-capabilities.html#TpCapabilities--channel-classes" title='The "channel-classes" property'>channel-classes</a>" GPtrArray_GValueArray_GHashTable_gchararray+GValue_+GStrv__* : Read / Write / Construct Only

"<a class="link" href="telepathy-glib-capabilities.html#TpCapabilities--contact-specific" title='The "contact-specific" property'>contact-specific</a>" gboolean : Read / Write / Construct Only

"<a class="link" href="telepathy-glib-capabilities.html#TpCapabilities--contact-specific" title='The "contact-specific" property'>contact-specific</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> : Read / Write / Construct Only

</pre>

</div>

100

<hr>

101

102

<a name="tp-capabilities-get-channel-classes"></a><h3>tp_capabilities_get_channel_classes ()</h3>

103

<pre class="programlisting">GPtrArray * tp_capabilities_get_channel_classes (<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>);</pre>

103

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> * tp_capabilities_get_channel_classes (<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>);</pre>

104

105

106

113

</tr>

114

<tr>

115

<td>Returns :</td>

116

<td>the same GPtrArray as the

116

<td>the same <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> as the

117

<a class="link" href="telepathy-glib-capabilities.html#TpCapabilities--channel-classes" title='The "channel-classes" property'>"channel-classes"</a> property. [<acronym title="Don't free data after the code is done.">transfer none</acronym>]

118

</td>

119

</tr>

124

<hr>

125

126

<a name="tp-capabilities-is-specific-to-contact"></a><h3>tp_capabilities_is_specific_to_contact ()</h3>

127

<pre class="programlisting">gboolean tp_capabilities_is_specific_to_contact

127

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

128

(<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>);</pre>

129

130

138

</tr>

139

<tr>

140

<td>Returns :</td>

141

<td>the same gboolean as the <a class="link" href="telepathy-glib-capabilities.html#TpCapabilities--contact-specific" title='The "contact-specific" property'>"contact-specific"</a> property</td>

141

<td>the same <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> as the <a class="link" href="telepathy-glib-capabilities.html#TpCapabilities--contact-specific" title='The "contact-specific" property'>"contact-specific"</a> property</td>

142

</tr>

143

</tbody>

144

</table></div>

147

<hr>

148

149

<a name="tp-capabilities-supports-text-chatrooms"></a><h3>tp_capabilities_supports_text_chatrooms ()</h3>

150

<pre class="programlisting">gboolean tp_capabilities_supports_text_chatrooms

150

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

151

(<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>);</pre>

152

153

If the <a class="link" href="telepathy-glib-capabilities.html#TpCapabilities--contact-specific" title='The "contact-specific" property'>"contact-specific"</a> property is <code class="literal">FALSE</code>, this function

153

154

checks if named text chatrooms can be joined by providing a chatroom

155

identifier.

156

157

158

159

checks if the contact associated with this <a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> can be invited

160

to named text chatrooms.

161

162

163

If the protocol is such that chatrooms can be joined or contacts can be

164

invited, but only via a more elaborate D-Bus API than normal

165

(because more information is needed), then this method will return <code class="literal">FALSE</code>.

165

(because more information is needed), then this method will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.

166

167

168

174

<tr>

175

<td>Returns :</td>

176

<td>

177

<code class="literal">TRUE</code> if a channel request containing Text as ChannelType,

177

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a channel request containing Text as ChannelType,

178

HandleTypeRoom as TargetHandleType and a channel identifier can be

179

expected to work, <code class="literal">FALSE</code> otherwise.</td>

179

expected to work, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>

180

</tr>

181

</tbody>

182

</table></div>

185

<hr>

186

187

<a name="tp-capabilities-supports-text-chats"></a><h3>tp_capabilities_supports_text_chats ()</h3>

188

<pre class="programlisting">gboolean tp_capabilities_supports_text_chats (<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>);</pre>

188

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> tp_capabilities_supports_text_chats (<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>);</pre>

189

190

Return whether private text channels can be established by providing

191

a contact identifier.

193

194

If the protocol is such that text chats can be established, but only via a

195

more elaborate D-Bus API than normal (because more information is needed),

196

then this method will return <code class="literal">FALSE</code>.

196

then this method will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.

197

198

199

205

<tr>

206

<td>Returns :</td>

207

<td>

208

<code class="literal">TRUE</code> if a channel request containing Text as ChannelType,

208

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a channel request containing Text as ChannelType,

209

HandleTypeContact as TargetHandleType and a contact identifier can be

210

expected to work, <code class="literal">FALSE</code> otherwise.</td>

210

expected to work, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>

211

</tr>

212

</tbody>

213

</table></div>

216

<hr>

217

218

<a name="tp-capabilities-supports-stream-tubes"></a><h3>tp_capabilities_supports_stream_tubes ()</h3>

219

<pre class="programlisting">gboolean tp_capabilities_supports_stream_tubes

219

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

220

(<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>,

221

<code><a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType">TpHandleType</a> handle_type</code>,

222

<code>const gchar *service</code>);</pre>

222

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

223

224

225

checks if the contact associated with this <a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> supports

226

stream tubes with <code>handle_type</code> as TargetHandleType.

227

If <code>service</code> is not <code class="literal">NULL</code>, it also checks if it supports stream tubes

227

If <code>service</code> is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, it also checks if it supports stream tubes

228

with <code>service</code> as <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-STREAM-TUBE-SERVICE:CAPS" title="TP_PROP_CHANNEL_TYPE_STREAM_TUBE_SERVICE">TP_PROP_CHANNEL_TYPE_STREAM_TUBE_SERVICE</a>.

229

230

231

232

checks if the connection supports requesting stream tube channels with

233

<code>handle_type</code> as ChannelType. The <code>service</code> argument is unused in this case.

234

246

</tr>

247

<tr>

248

<td><code>service</code> :</td>

249

<td>the service of the tube, or <code class="literal">NULL</code>

249

<td>the service of the tube, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

250

</td>

251

</tr>

252

<tr>

253

<td>Returns :</td>

254

<td>

255

<code class="literal">TRUE</code> if the contact or connection supports this type of stream

255

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the contact or connection supports this type of stream

256

tubes.</td>

257

</tr>

258

</tbody>

262

<hr>

263

264

<a name="tp-capabilities-supports-dbus-tubes"></a><h3>tp_capabilities_supports_dbus_tubes ()</h3>

265

<pre class="programlisting">gboolean tp_capabilities_supports_dbus_tubes (<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>,

265

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> tp_capabilities_supports_dbus_tubes (<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>,

266

<code><a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType">TpHandleType</a> handle_type</code>,

267

<code>const gchar *service_name</code>);</pre>

267

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

268

269

270

checks if the contact associated with this <a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> supports

271

D-Bus tubes with <code>handle_type</code> as TargetHandleType.

272

If <code>service_name</code> is not <code class="literal">NULL</code>, it also checks if it supports stream tubes

272

If <code>service_name</code> is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, it also checks if it supports stream tubes

273

with <code>service</code> as <a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-DBUS-TUBE-SERVICE-NAME:CAPS" title="TP_PROP_CHANNEL_TYPE_DBUS_TUBE_SERVICE_NAME">TP_PROP_CHANNEL_TYPE_DBUS_TUBE_SERVICE_NAME</a>.

274

275

276

277

checks if the connection supports requesting D-Bus tube channels with

278

<code>handle_type</code> as ChannelType. The <code>service_name</code> argument is unused in

279

this case.

292

</tr>

293

<tr>

294

<td><code>service_name</code> :</td>

295

<td>the service name of the tube, or <code class="literal">NULL</code>

295

<td>the service name of the tube, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

296

</td>

297

</tr>

298

<tr>

299

<td>Returns :</td>

300

<td>

301

<code class="literal">TRUE</code> if the contact or connection supports this type of D-Bus

301

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the contact or connection supports this type of D-Bus

302

tubes.</td>

303

</tr>

304

</tbody>

308

<hr>

309

310

<a name="tp-capabilities-supports-contact-search"></a><h3>tp_capabilities_supports_contact_search ()</h3>

311

<pre class="programlisting">gboolean tp_capabilities_supports_contact_search

311

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

312

(<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>,

313

<code>gboolean *with_limit</code>,

314

<code>gboolean *with_server</code>);</pre>

313

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

314

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

315

316

Return whether this protocol or connection can perform contact

317

searches. Optionally, also return whether a limited number of

327

</tr>

328

<tr>

329

<td><code>with_limit</code> :</td>

330

<td>if not <code class="literal">NULL</code>, used to return <code class="literal">TRUE</code> if the limit

330

<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 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the limit

331

parameter to <a class="link" href="telepathy-glib-contact-search.html#tp-contact-search-new-async" title="tp_contact_search_new_async ()"><code class="function">tp_contact_search_new_async()</code></a> and

332

<a class="link" href="telepathy-glib-contact-search.html#tp-contact-search-reset-async" title="tp_contact_search_reset_async ()"><code class="function">tp_contact_search_reset_async()</code></a> can be nonzero. [<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>]

333

</td>

334

</tr>

335

<tr>

336

<td><code>with_server</code> :</td>

337

<td>if not <code class="literal">NULL</code>, used to return <code class="literal">TRUE</code> if the server

337

338

339

<a class="link" href="telepathy-glib-contact-search.html#tp-contact-search-reset-async" title="tp_contact_search_reset_async ()"><code class="function">tp_contact_search_reset_async()</code></a> can be non-<code class="literal">NULL</code>. [<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>]

339

<a class="link" href="telepathy-glib-contact-search.html#tp-contact-search-reset-async" title="tp_contact_search_reset_async ()"><code class="function">tp_contact_search_reset_async()</code></a> can be non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>]

340

</td>

341

</tr>

342

<tr>

343

<td>Returns :</td>

344

<td>

345

<code class="literal">TRUE</code> if <a class="link" href="telepathy-glib-contact-search.html#TpContactSearch">TpContactSearch</a> can be used.</td>

345

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <a class="link" href="telepathy-glib-contact-search.html#TpContactSearch">TpContactSearch</a> can be used.</td>

346

</tr>

347

</tbody>

348

</table></div>

351

<hr>

352

353

<a name="tp-capabilities-supports-room-list"></a><h3>tp_capabilities_supports_room_list ()</h3>

354

<pre class="programlisting">gboolean tp_capabilities_supports_room_list (<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>,

355

<code>gboolean *with_server</code>);</pre>

354

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> tp_capabilities_supports_room_list (<code><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities">TpCapabilities</a> *self</code>,

355

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

356

357

Discovers whether this protocol or connection supports listing rooms.

358

Specifically, if this function returns <code class="literal">TRUE</code>, a room list channel can be

358

Specifically, if this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, a room list channel can be

359

requested as follows:

360

361

362

GHashTable *request;

363

TpAccountChannelRequest *req;

364

365

request = tp_asv_new (

366

TP_PROP_CHANNEL_CHANNEL_TYPE, G_TYPE_STRING,

367

TP_IFACE_CHANNEL_TYPE_ROOM_LIST,

368

TP_PROP_CHANNEL_TARGET_HANDLE_TYPE, G_TYPE_UINT, TP_HANDLE_TYPE_NONE,

369

NULL);

370

371

req = tp_account_channel_request_new (account, request,

372

TP_USER_ACTION_TIME_CURRENT_TIME);

373

374

tp_account_channel_request_create_and_handle_channel_async (req, NULL,

375

create_channel_cb, NULL);

376

377

g_object_unref (req);

378

g_hash_table_unref (request);

379

</pre></div>

361

362

363

<tbody>

364

<tr>

365

<td class="listing_lines" align="right"><pre>1

366

367

368

369

370

371

372

373

374

375

376

377

378

379

380

381

17</pre></td>

382

<td class="listing_code"><pre class="programlisting">GHashTable *request;

383

TpAccountChannelRequest *req;

384

385

request = <a href="telepathy-glib-asv.html#tp-asv-new">tp_asv_new</a> (

386

TP_PROP_CHANNEL_CHANNEL_TYPE, G_TYPE_STRING,

387

TP_IFACE_CHANNEL_TYPE_ROOM_LIST,

388

TP_PROP_CHANNEL_TARGET_HANDLE_TYPE, G_TYPE_UINT, TP_HANDLE_TYPE_NONE,

389

NULL);

390

391

req = <a href="telepathy-glib-account-channel-request.html#tp-account-channel-request-new">tp_account_channel_request_new</a> (account, request,

392

TP_USER_ACTION_TIME_CURRENT_TIME);

393

394

<a href="telepathy-glib-account-channel-request.html#tp-account-channel-request-create-and-handle-channel-async">tp_account_channel_request_create_and_handle_channel_async</a> (req, NULL,

395

create_channel_cb, NULL);

396

397

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a> (req);

398

<a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#g-hash-table-unref">g_hash_table_unref</a> (request);</pre></td>

399

</tr>

400

</tbody>

401

</table>

402

</div>

403

380

404

381

405

382

406

383

If <code>with_server</code> is set to <code class="literal">TRUE</code>, a list of rooms on a particular server can

407

If <code>with_server</code> is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, a list of rooms on a particular server can

384

408

be requested as follows:

385

409

386

387

/\* Same code as above but with request defined using: *\/

388

request = tp_asv_new (

389

TP_PROP_CHANNEL_CHANNEL_TYPE, G_TYPE_STRING,

390

TP_IFACE_CHANNEL_TYPE_ROOM_LIST,

391

TP_PROP_CHANNEL_TARGET_HANDLE_TYPE, G_TYPE_UINT, TP_HANDLE_TYPE_NONE,

392

TP_PROP_CHANNEL_TYPE_ROOM_LIST_SERVER, G_TYPE_STRING,

393

"characters.shakespeare.lit",

394

NULL);

395

</pre></div>

410

411

412

<tbody>

413

<tr>

414

<td class="listing_lines" align="right"><pre>1

415

416

417

418

419

420

421

8</pre></td>

422

<td class="listing_code"><pre class="programlisting">/\* Same code as above but with request defined using: *\/

423

request = <a href="telepathy-glib-asv.html#tp-asv-new">tp_asv_new</a> (

424

TP_PROP_CHANNEL_CHANNEL_TYPE, G_TYPE_STRING,

425

TP_IFACE_CHANNEL_TYPE_ROOM_LIST,

426

TP_PROP_CHANNEL_TARGET_HANDLE_TYPE, G_TYPE_UINT, TP_HANDLE_TYPE_NONE,

427

TP_PROP_CHANNEL_TYPE_ROOM_LIST_SERVER, G_TYPE_STRING,

428

"characters.shakespeare.lit",

429

NULL);</pre></td>

430

</tr>

431

</tbody>

432

</table>

433

</div>

434

396

435

397

436

398

437

404

443

</tr>

405

444

<tr>

406

445

<td><code>with_server</code> :</td>

407

<td>if not <code class="literal">NULL</code>, used to return <code class="literal">TRUE</code> if the

446

408

447

<a class="link" href="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TYPE-ROOM-LIST-SERVER:CAPS" title="TP_PROP_CHANNEL_TYPE_ROOM_LIST_SERVER">TP_PROP_CHANNEL_TYPE_ROOM_LIST_SERVER</a> property can be defined when

409

448

requesting a RoomList channel. [<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>]

410

449

</td>

412

451

<tr>

413

452

<td>Returns :</td>

414

453

<td>

415

<code class="literal">TRUE</code> if a channel request containing RoomList as ChannelType,

454

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a channel request containing RoomList as ChannelType,

416

455

HandleTypeNone as TargetHandleType can be expected to work,

417

<code class="literal">FALSE</code> otherwise.</td>

456

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

418

457

</tr>

419

458

</tbody>

420

459

</table></div>

433

472

434

473

This can be used by advanced clients to determine whether an unusually

435

474

complex request would succeed. See the Telepathy D-Bus API Specification

436

for details of how to interpret the returned GPtrArray of

475

for details of how to interpret the returned <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> of

437

476

<a class="link" href="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-REQUESTABLE-CHANNEL-CLASS:CAPS" title="TP_STRUCT_TYPE_REQUESTABLE_CHANNEL_CLASS">TP_STRUCT_TYPE_REQUESTABLE_CHANNEL_CLASS</a>.

438

477

439

478

445

484

<hr>

446

485

447

486

<a name="TpCapabilities--contact-specific"></a><h3>The <code class="literal">"contact-specific"</code> property</h3>

448

<pre class="programlisting"> "contact-specific" gboolean : Read / Write / Construct Only</pre>

487

<pre class="programlisting"> "contact-specific" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> : Read / Write / Construct Only</pre>

449

488

450

489

Whether this object accurately describes the capabilities of a particular

451

490

contact, or if it's only a guess based on the capabilities of the

457

496

</div>

458

497

459

498

<hr>

460

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

499

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

461

500

</body>

462

501

</html>

b'\\ No newline at end of file'

Older »