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

« back to all changes in this revision

Viewing changes to docs/reference/html/telepathy-glib-svc-connection.html

  • Committer: Ken VanDine
  • Date: 2012-02-22 18:08:37 UTC
  • mfrom: (1.6.39)
  • Revision ID: ken.vandine@canonical.com-20120222180837-02um6fex0eg073lf
New upstream release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
43
43
</tr></table></div>
44
44
<div class="refsynopsisdiv">
45
45
<a name="telepathy-glib-svc-connection.synopsis"></a><h2>Synopsis</h2>
46
 
<a name="TpSvcConnection"></a><a name="TpSvcConnectionInterfaceContacts"></a><a name="TpSvcConnectionInterfaceRequests"></a><a name="TpSvcConnectionInterfaceSimplePresence"></a><a name="TpSvcConnectionInterfacePresence"></a><a name="TpSvcConnectionInterfaceAvatars"></a><a name="TpSvcConnectionInterfaceAliasing"></a><a name="TpSvcConnectionInterfaceBalance"></a><a name="TpSvcConnectionInterfaceCapabilities"></a><a name="TpSvcConnectionInterfaceContactCapabilities"></a><a name="TpSvcConnectionInterfaceLocation"></a><a name="TpSvcConnectionInterfaceContactInfo"></a><a name="TpSvcConnectionInterfaceContactBlocking"></a><a name="TpSvcConnectionInterfaceContactGroups"></a><a name="TpSvcConnectionInterfaceContactList"></a><a name="TpSvcConnectionInterfaceCellular"></a><a name="TpSvcConnectionInterfaceClientTypes"></a><a name="TpSvcConnectionInterfaceMailNotification"></a><a name="TpSvcConnectionInterfacePowerSaving"></a><pre class="synopsis">
 
46
<a name="TpSvcConnection"></a><a name="TpSvcConnectionInterfaceContacts"></a><a name="TpSvcConnectionInterfaceRequests"></a><a name="TpSvcConnectionInterfaceSimplePresence"></a><a name="TpSvcConnectionInterfacePresence"></a><a name="TpSvcConnectionInterfaceAvatars"></a><a name="TpSvcConnectionInterfaceAliasing"></a><a name="TpSvcConnectionInterfaceBalance"></a><a name="TpSvcConnectionInterfaceCapabilities"></a><a name="TpSvcConnectionInterfaceContactCapabilities"></a><a name="TpSvcConnectionInterfaceLocation"></a><a name="TpSvcConnectionInterfaceContactInfo"></a><a name="TpSvcConnectionInterfaceContactBlocking"></a><a name="TpSvcConnectionInterfaceContactGroups"></a><a name="TpSvcConnectionInterfaceContactList"></a><a name="TpSvcConnectionInterfaceCellular"></a><a name="TpSvcConnectionInterfaceClientTypes"></a><a name="TpSvcConnectionInterfaceMailNotification"></a><a name="TpSvcConnectionInterfacePowerSaving"></a><a name="TpSvcConnectionInterfaceAddressing"></a><pre class="synopsis">
47
47
#include &lt;telepathy-glib/svc-connection.h&gt;
48
48
 
49
49
                    <a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnection-struct" title="TpSvcConnection">TpSvcConnection</a>;
747
747
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactList"><span class="type">TpSvcConnectionInterfaceContactList</span></a> *self</code></em>,
748
748
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Contacts</code></em>,
749
749
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>);
 
750
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-list-download-impl" title="tp_svc_connection_interface_contact_list_download_impl ()">*tp_svc_connection_interface_contact_list_download_impl</a>)
 
751
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactList"><span class="type">TpSvcConnectionInterfaceContactList</span></a> *self</code></em>,
 
752
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>);
750
753
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-list-emit-contacts-changed" title="tp_svc_connection_interface_contact_list_emit_contacts_changed ()">tp_svc_connection_interface_contact_list_emit_contacts_changed</a>
751
754
                                                        (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
752
755
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *arg_Changes</code></em>,
767
770
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-list-implement-authorize-publication" title="tp_svc_connection_interface_contact_list_implement_authorize_publication ()">tp_svc_connection_interface_contact_list_implement_authorize_publication</a>
768
771
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactListClass" title="TpSvcConnectionInterfaceContactListClass"><span class="type">TpSvcConnectionInterfaceContactListClass</span></a> *klass</code></em>,
769
772
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-list-authorize-publication-impl" title="tp_svc_connection_interface_contact_list_authorize_publication_impl ()"><span class="type">tp_svc_connection_interface_contact_list_authorize_publication_impl</span></a> impl</code></em>);
 
773
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-list-implement-download" title="tp_svc_connection_interface_contact_list_implement_download ()">tp_svc_connection_interface_contact_list_implement_download</a>
 
774
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactListClass" title="TpSvcConnectionInterfaceContactListClass"><span class="type">TpSvcConnectionInterfaceContactListClass</span></a> *klass</code></em>,
 
775
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-list-download-impl" title="tp_svc_connection_interface_contact_list_download_impl ()"><span class="type">tp_svc_connection_interface_contact_list_download_impl</span></a> impl</code></em>);
770
776
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-list-implement-get-contact-list-attributes" title="tp_svc_connection_interface_contact_list_implement_get_contact_list_attributes ()">tp_svc_connection_interface_contact_list_implement_get_contact_list_attributes</a>
771
777
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactListClass" title="TpSvcConnectionInterfaceContactListClass"><span class="type">TpSvcConnectionInterfaceContactListClass</span></a> *klass</code></em>,
772
778
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-list-get-contact-list-attributes-impl" title="tp_svc_connection_interface_contact_list_get_contact_list_attributes_impl ()"><span class="type">tp_svc_connection_interface_contact_list_get_contact_list_attributes_impl</span></a> impl</code></em>);
793
799
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>);
794
800
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-list-return-from-authorize-publication" title="tp_svc_connection_interface_contact_list_return_from_authorize_publication ()">tp_svc_connection_interface_contact_list_return_from_authorize_publication</a>
795
801
                                                        (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>);
 
802
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-list-return-from-download" title="tp_svc_connection_interface_contact_list_return_from_download ()">tp_svc_connection_interface_contact_list_return_from_download</a>
 
803
                                                        (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>);
796
804
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-list-return-from-get-contact-list-attributes" title="tp_svc_connection_interface_contact_list_return_from_get_contact_list_attributes ()">tp_svc_connection_interface_contact_list_return_from_get_contact_list_attributes</a>
797
805
                                                        (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>,
798
806
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Attributes</code></em>);
895
903
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfacePowerSaving"><span class="type">TpSvcConnectionInterfacePowerSaving</span></a> *self</code></em>,
896
904
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> in_Activate</code></em>,
897
905
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>);
 
906
 
 
907
 
 
908
                    <a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceAddressing-struct" title="TpSvcConnectionInterfaceAddressing">TpSvcConnectionInterfaceAddressing</a>;
 
909
                    <a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceAddressingClass" title="TpSvcConnectionInterfaceAddressingClass">TpSvcConnectionInterfaceAddressingClass</a>;
 
910
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-addressing-get-contacts-by-uri-impl" title="tp_svc_connection_interface_addressing_get_contacts_by_uri_impl ()">*tp_svc_connection_interface_addressing_get_contacts_by_uri_impl</a>)
 
911
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceAddressing"><span class="type">TpSvcConnectionInterfaceAddressing</span></a> *self</code></em>,
 
912
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **in_URIs</code></em>,
 
913
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **in_Interfaces</code></em>,
 
914
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>);
 
915
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-addressing-get-contacts-by-vcard-field-impl" title="tp_svc_connection_interface_addressing_get_contacts_by_vcard_field_impl ()">*tp_svc_connection_interface_addressing_get_contacts_by_vcard_field_impl</a>)
 
916
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceAddressing"><span class="type">TpSvcConnectionInterfaceAddressing</span></a> *self</code></em>,
 
917
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_Field</code></em>,
 
918
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **in_Addresses</code></em>,
 
919
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **in_Interfaces</code></em>,
 
920
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>);
 
921
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-addressing-implement-get-contacts-by-uri" title="tp_svc_connection_interface_addressing_implement_get_contacts_by_uri ()">tp_svc_connection_interface_addressing_implement_get_contacts_by_uri</a>
 
922
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceAddressingClass" title="TpSvcConnectionInterfaceAddressingClass"><span class="type">TpSvcConnectionInterfaceAddressingClass</span></a> *klass</code></em>,
 
923
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-addressing-get-contacts-by-uri-impl" title="tp_svc_connection_interface_addressing_get_contacts_by_uri_impl ()"><span class="type">tp_svc_connection_interface_addressing_get_contacts_by_uri_impl</span></a> impl</code></em>);
 
924
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-addressing-implement-get-contacts-by-vcard-field" title="tp_svc_connection_interface_addressing_implement_get_contacts_by_vcard_field ()">tp_svc_connection_interface_addressing_implement_get_contacts_by_vcard_field</a>
 
925
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceAddressingClass" title="TpSvcConnectionInterfaceAddressingClass"><span class="type">TpSvcConnectionInterfaceAddressingClass</span></a> *klass</code></em>,
 
926
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-addressing-get-contacts-by-vcard-field-impl" title="tp_svc_connection_interface_addressing_get_contacts_by_vcard_field_impl ()"><span class="type">tp_svc_connection_interface_addressing_get_contacts_by_vcard_field_impl</span></a> impl</code></em>);
 
927
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-addressing-return-from-get-contacts-by-uri" title="tp_svc_connection_interface_addressing_return_from_get_contacts_by_uri ()">tp_svc_connection_interface_addressing_return_from_get_contacts_by_uri</a>
 
928
                                                        (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>,
 
929
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Requested</code></em>,
 
930
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Attributes</code></em>);
 
931
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-addressing-return-from-get-contacts-by-vcard-field" title="tp_svc_connection_interface_addressing_return_from_get_contacts_by_vcard_field ()">tp_svc_connection_interface_addressing_return_from_get_contacts_by_vcard_field</a>
 
932
                                                        (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>,
 
933
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Requested</code></em>,
 
934
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Attributes</code></em>);
898
935
</pre>
899
936
</div>
900
937
<div class="refsect1">
975
1012
  GInterface
976
1013
   +----TpSvcConnectionInterfacePowerSaving
977
1014
</pre>
 
1015
<pre class="synopsis">
 
1016
  GInterface
 
1017
   +----TpSvcConnectionInterfaceAddressing
 
1018
</pre>
978
1019
</div>
979
1020
<div class="refsect1">
980
1021
<a name="telepathy-glib-svc-connection.implementations"></a><h2>Known Implementations</h2>
6595
6636
  IMPLEMENT (remove_contacts);
6596
6637
  IMPLEMENT (unsubscribe);
6597
6638
  IMPLEMENT (unpublish);
 
6639
  IMPLEMENT (download);
6598
6640
#undef IMPLEMENT
6599
6641
}
6600
6642
</pre>
6632
6674
</div>
6633
6675
<hr>
6634
6676
<div class="refsect2">
 
6677
<a name="tp-svc-connection-interface-contact-list-download-impl"></a><h3>tp_svc_connection_interface_contact_list_download_impl ()</h3>
 
6678
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_svc_connection_interface_contact_list_download_impl)
 
6679
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactList"><span class="type">TpSvcConnectionInterfaceContactList</span></a> *self</code></em>,
 
6680
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>);</pre>
 
6681
<p>
 
6682
The signature of an implementation of the D-Bus method
 
6683
Download on interface org.freedesktop.Telepathy.Connection.Interface.ContactList.
 
6684
</p>
 
6685
<div class="variablelist"><table border="0">
 
6686
<col align="left" valign="top">
 
6687
<tbody>
 
6688
<tr>
 
6689
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
6690
<td>The object implementing this interface</td>
 
6691
</tr>
 
6692
<tr>
 
6693
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
6694
<td>Used to return values or throw an error</td>
 
6695
</tr>
 
6696
</tbody>
 
6697
</table></div>
 
6698
</div>
 
6699
<hr>
 
6700
<div class="refsect2">
6635
6701
<a name="tp-svc-connection-interface-contact-list-emit-contacts-changed"></a><h3>tp_svc_connection_interface_contact_list_emit_contacts_changed ()</h3>
6636
6702
<pre class="programlisting"><span class="returnvalue">void</span>                tp_svc_connection_interface_contact_list_emit_contacts_changed
6637
6703
                                                        (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
6778
6844
</div>
6779
6845
<hr>
6780
6846
<div class="refsect2">
 
6847
<a name="tp-svc-connection-interface-contact-list-implement-download"></a><h3>tp_svc_connection_interface_contact_list_implement_download ()</h3>
 
6848
<pre class="programlisting"><span class="returnvalue">void</span>                tp_svc_connection_interface_contact_list_implement_download
 
6849
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactListClass" title="TpSvcConnectionInterfaceContactListClass"><span class="type">TpSvcConnectionInterfaceContactListClass</span></a> *klass</code></em>,
 
6850
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-contact-list-download-impl" title="tp_svc_connection_interface_contact_list_download_impl ()"><span class="type">tp_svc_connection_interface_contact_list_download_impl</span></a> impl</code></em>);</pre>
 
6851
<p>
 
6852
Register an implementation for the Download method in the vtable
 
6853
of an implementation of this interface. To be called from
 
6854
the interface init function.
 
6855
</p>
 
6856
<div class="variablelist"><table border="0">
 
6857
<col align="left" valign="top">
 
6858
<tbody>
 
6859
<tr>
 
6860
<td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
 
6861
<td>A class whose instances implement this interface</td>
 
6862
</tr>
 
6863
<tr>
 
6864
<td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
 
6865
<td>A callback used to implement the Download D-Bus method</td>
 
6866
</tr>
 
6867
</tbody>
 
6868
</table></div>
 
6869
</div>
 
6870
<hr>
 
6871
<div class="refsect2">
6781
6872
<a name="tp-svc-connection-interface-contact-list-implement-get-contact-list-attributes"></a><h3>tp_svc_connection_interface_contact_list_implement_get_contact_list_attributes ()</h3>
6782
6873
<pre class="programlisting"><span class="returnvalue">void</span>                tp_svc_connection_interface_contact_list_implement_get_contact_list_attributes
6783
6874
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceContactListClass" title="TpSvcConnectionInterfaceContactListClass"><span class="type">TpSvcConnectionInterfaceContactListClass</span></a> *klass</code></em>,
6983
7074
</div>
6984
7075
<hr>
6985
7076
<div class="refsect2">
 
7077
<a name="tp-svc-connection-interface-contact-list-return-from-download"></a><h3>tp_svc_connection_interface_contact_list_return_from_download ()</h3>
 
7078
<pre class="programlisting"><span class="returnvalue">void</span>                tp_svc_connection_interface_contact_list_return_from_download
 
7079
                                                        (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>);</pre>
 
7080
<p>
 
7081
Return successfully by calling <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"><code class="function">dbus_g_method_return()</code></a>.
 
7082
This inline function exists only to provide type-safety.
 
7083
</p>
 
7084
<div class="variablelist"><table border="0">
 
7085
<col align="left" valign="top">
 
7086
<tbody><tr>
 
7087
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
7088
<td>The D-Bus method invocation context</td>
 
7089
</tr></tbody>
 
7090
</table></div>
 
7091
</div>
 
7092
<hr>
 
7093
<div class="refsect2">
6986
7094
<a name="tp-svc-connection-interface-contact-list-return-from-get-contact-list-attributes"></a><h3>tp_svc_connection_interface_contact_list_return_from_get_contact_list_attributes ()</h3>
6987
7095
<pre class="programlisting"><span class="returnvalue">void</span>                tp_svc_connection_interface_contact_list_return_from_get_contact_list_attributes
6988
7096
                                                        (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>,
7782
7890
</tbody>
7783
7891
</table></div>
7784
7892
</div>
 
7893
<hr>
 
7894
<div class="refsect2">
 
7895
<a name="TpSvcConnectionInterfaceAddressing-struct"></a><h3>TpSvcConnectionInterfaceAddressing</h3>
 
7896
<pre class="programlisting">typedef struct _TpSvcConnectionInterfaceAddressing TpSvcConnectionInterfaceAddressing;</pre>
 
7897
<p>
 
7898
Dummy typedef representing any implementation of this interface.
 
7899
</p>
 
7900
</div>
 
7901
<hr>
 
7902
<div class="refsect2">
 
7903
<a name="TpSvcConnectionInterfaceAddressingClass"></a><h3>TpSvcConnectionInterfaceAddressingClass</h3>
 
7904
<pre class="programlisting">typedef struct _TpSvcConnectionInterfaceAddressingClass TpSvcConnectionInterfaceAddressingClass;</pre>
 
7905
<p>
 
7906
The class of TpSvcConnectionInterfaceAddressing.
 
7907
</p>
 
7908
<p>
 
7909
In a full implementation of this interface (i.e. all
 
7910
methods implemented), the interface initialization
 
7911
function used in <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-IMPLEMENT-INTERFACE:CAPS"><code class="function">G_IMPLEMENT_INTERFACE()</code></a> would
 
7912
typically look like this:
 
7913
</p>
 
7914
<p>
 
7915
</p>
 
7916
<pre class="programlisting">
 
7917
static void
 
7918
implement_connection_interface_addressing (gpointer klass,
 
7919
    gpointer unused G_GNUC_UNUSED)
 
7920
{
 
7921
#define IMPLEMENT(x) tp_svc_connection_interface_addressing_implement_##x (\
 
7922
  klass, my_object_##x)
 
7923
  IMPLEMENT (get_contacts_by_vcard_field);
 
7924
  IMPLEMENT (get_contacts_by_uri);
 
7925
#undef IMPLEMENT
 
7926
}
 
7927
</pre>
 
7928
<p>
 
7929
</p>
 
7930
</div>
 
7931
<hr>
 
7932
<div class="refsect2">
 
7933
<a name="tp-svc-connection-interface-addressing-get-contacts-by-uri-impl"></a><h3>tp_svc_connection_interface_addressing_get_contacts_by_uri_impl ()</h3>
 
7934
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_svc_connection_interface_addressing_get_contacts_by_uri_impl)
 
7935
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceAddressing"><span class="type">TpSvcConnectionInterfaceAddressing</span></a> *self</code></em>,
 
7936
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **in_URIs</code></em>,
 
7937
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **in_Interfaces</code></em>,
 
7938
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>);</pre>
 
7939
<p>
 
7940
The signature of an implementation of the D-Bus method
 
7941
GetContactsByURI on interface org.freedesktop.Telepathy.Connection.Interface.Addressing1.
 
7942
</p>
 
7943
<div class="variablelist"><table border="0">
 
7944
<col align="left" valign="top">
 
7945
<tbody>
 
7946
<tr>
 
7947
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
7948
<td>The object implementing this interface</td>
 
7949
</tr>
 
7950
<tr>
 
7951
<td><p><span class="term"><em class="parameter"><code>in_URIs</code></em> :</span></p></td>
 
7952
<td>const gchar ** (FIXME, generate documentation)</td>
 
7953
</tr>
 
7954
<tr>
 
7955
<td><p><span class="term"><em class="parameter"><code>in_Interfaces</code></em> :</span></p></td>
 
7956
<td>const gchar ** (FIXME, generate documentation)</td>
 
7957
</tr>
 
7958
<tr>
 
7959
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
7960
<td>Used to return values or throw an error</td>
 
7961
</tr>
 
7962
</tbody>
 
7963
</table></div>
 
7964
</div>
 
7965
<hr>
 
7966
<div class="refsect2">
 
7967
<a name="tp-svc-connection-interface-addressing-get-contacts-by-vcard-field-impl"></a><h3>tp_svc_connection_interface_addressing_get_contacts_by_vcard_field_impl ()</h3>
 
7968
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_svc_connection_interface_addressing_get_contacts_by_vcard_field_impl)
 
7969
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceAddressing"><span class="type">TpSvcConnectionInterfaceAddressing</span></a> *self</code></em>,
 
7970
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_Field</code></em>,
 
7971
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **in_Addresses</code></em>,
 
7972
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **in_Interfaces</code></em>,
 
7973
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>);</pre>
 
7974
<p>
 
7975
The signature of an implementation of the D-Bus method
 
7976
GetContactsByVCardField on interface org.freedesktop.Telepathy.Connection.Interface.Addressing1.
 
7977
</p>
 
7978
<div class="variablelist"><table border="0">
 
7979
<col align="left" valign="top">
 
7980
<tbody>
 
7981
<tr>
 
7982
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
7983
<td>The object implementing this interface</td>
 
7984
</tr>
 
7985
<tr>
 
7986
<td><p><span class="term"><em class="parameter"><code>in_Field</code></em> :</span></p></td>
 
7987
<td>const gchar * (FIXME, generate documentation)</td>
 
7988
</tr>
 
7989
<tr>
 
7990
<td><p><span class="term"><em class="parameter"><code>in_Addresses</code></em> :</span></p></td>
 
7991
<td>const gchar ** (FIXME, generate documentation)</td>
 
7992
</tr>
 
7993
<tr>
 
7994
<td><p><span class="term"><em class="parameter"><code>in_Interfaces</code></em> :</span></p></td>
 
7995
<td>const gchar ** (FIXME, generate documentation)</td>
 
7996
</tr>
 
7997
<tr>
 
7998
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
7999
<td>Used to return values or throw an error</td>
 
8000
</tr>
 
8001
</tbody>
 
8002
</table></div>
 
8003
</div>
 
8004
<hr>
 
8005
<div class="refsect2">
 
8006
<a name="tp-svc-connection-interface-addressing-implement-get-contacts-by-uri"></a><h3>tp_svc_connection_interface_addressing_implement_get_contacts_by_uri ()</h3>
 
8007
<pre class="programlisting"><span class="returnvalue">void</span>                tp_svc_connection_interface_addressing_implement_get_contacts_by_uri
 
8008
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceAddressingClass" title="TpSvcConnectionInterfaceAddressingClass"><span class="type">TpSvcConnectionInterfaceAddressingClass</span></a> *klass</code></em>,
 
8009
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-addressing-get-contacts-by-uri-impl" title="tp_svc_connection_interface_addressing_get_contacts_by_uri_impl ()"><span class="type">tp_svc_connection_interface_addressing_get_contacts_by_uri_impl</span></a> impl</code></em>);</pre>
 
8010
<p>
 
8011
Register an implementation for the GetContactsByURI method in the vtable
 
8012
of an implementation of this interface. To be called from
 
8013
the interface init function.
 
8014
</p>
 
8015
<div class="variablelist"><table border="0">
 
8016
<col align="left" valign="top">
 
8017
<tbody>
 
8018
<tr>
 
8019
<td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
 
8020
<td>A class whose instances implement this interface</td>
 
8021
</tr>
 
8022
<tr>
 
8023
<td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
 
8024
<td>A callback used to implement the GetContactsByURI D-Bus method</td>
 
8025
</tr>
 
8026
</tbody>
 
8027
</table></div>
 
8028
</div>
 
8029
<hr>
 
8030
<div class="refsect2">
 
8031
<a name="tp-svc-connection-interface-addressing-implement-get-contacts-by-vcard-field"></a><h3>tp_svc_connection_interface_addressing_implement_get_contacts_by_vcard_field ()</h3>
 
8032
<pre class="programlisting"><span class="returnvalue">void</span>                tp_svc_connection_interface_addressing_implement_get_contacts_by_vcard_field
 
8033
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#TpSvcConnectionInterfaceAddressingClass" title="TpSvcConnectionInterfaceAddressingClass"><span class="type">TpSvcConnectionInterfaceAddressingClass</span></a> *klass</code></em>,
 
8034
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-svc-connection.html#tp-svc-connection-interface-addressing-get-contacts-by-vcard-field-impl" title="tp_svc_connection_interface_addressing_get_contacts_by_vcard_field_impl ()"><span class="type">tp_svc_connection_interface_addressing_get_contacts_by_vcard_field_impl</span></a> impl</code></em>);</pre>
 
8035
<p>
 
8036
Register an implementation for the GetContactsByVCardField method in the vtable
 
8037
of an implementation of this interface. To be called from
 
8038
the interface init function.
 
8039
</p>
 
8040
<div class="variablelist"><table border="0">
 
8041
<col align="left" valign="top">
 
8042
<tbody>
 
8043
<tr>
 
8044
<td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
 
8045
<td>A class whose instances implement this interface</td>
 
8046
</tr>
 
8047
<tr>
 
8048
<td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
 
8049
<td>A callback used to implement the GetContactsByVCardField D-Bus method</td>
 
8050
</tr>
 
8051
</tbody>
 
8052
</table></div>
 
8053
</div>
 
8054
<hr>
 
8055
<div class="refsect2">
 
8056
<a name="tp-svc-connection-interface-addressing-return-from-get-contacts-by-uri"></a><h3>tp_svc_connection_interface_addressing_return_from_get_contacts_by_uri ()</h3>
 
8057
<pre class="programlisting"><span class="returnvalue">void</span>                tp_svc_connection_interface_addressing_return_from_get_contacts_by_uri
 
8058
                                                        (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>,
 
8059
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Requested</code></em>,
 
8060
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Attributes</code></em>);</pre>
 
8061
<p>
 
8062
Return successfully by calling <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"><code class="function">dbus_g_method_return()</code></a>.
 
8063
This inline function exists only to provide type-safety.
 
8064
</p>
 
8065
<div class="variablelist"><table border="0">
 
8066
<col align="left" valign="top">
 
8067
<tbody>
 
8068
<tr>
 
8069
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
8070
<td>The D-Bus method invocation context</td>
 
8071
</tr>
 
8072
<tr>
 
8073
<td><p><span class="term"><em class="parameter"><code>out_Requested</code></em> :</span></p></td>
 
8074
<td>GHashTable * (FIXME, generate documentation)</td>
 
8075
</tr>
 
8076
<tr>
 
8077
<td><p><span class="term"><em class="parameter"><code>out_Attributes</code></em> :</span></p></td>
 
8078
<td>GHashTable * (FIXME, generate documentation)</td>
 
8079
</tr>
 
8080
</tbody>
 
8081
</table></div>
 
8082
</div>
 
8083
<hr>
 
8084
<div class="refsect2">
 
8085
<a name="tp-svc-connection-interface-addressing-return-from-get-contacts-by-vcard-field"></a><h3>tp_svc_connection_interface_addressing_return_from_get_contacts_by_vcard_field ()</h3>
 
8086
<pre class="programlisting"><span class="returnvalue">void</span>                tp_svc_connection_interface_addressing_return_from_get_contacts_by_vcard_field
 
8087
                                                        (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>,
 
8088
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Requested</code></em>,
 
8089
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Attributes</code></em>);</pre>
 
8090
<p>
 
8091
Return successfully by calling <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"><code class="function">dbus_g_method_return()</code></a>.
 
8092
This inline function exists only to provide type-safety.
 
8093
</p>
 
8094
<div class="variablelist"><table border="0">
 
8095
<col align="left" valign="top">
 
8096
<tbody>
 
8097
<tr>
 
8098
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
8099
<td>The D-Bus method invocation context</td>
 
8100
</tr>
 
8101
<tr>
 
8102
<td><p><span class="term"><em class="parameter"><code>out_Requested</code></em> :</span></p></td>
 
8103
<td>GHashTable * (FIXME, generate documentation)</td>
 
8104
</tr>
 
8105
<tr>
 
8106
<td><p><span class="term"><em class="parameter"><code>out_Attributes</code></em> :</span></p></td>
 
8107
<td>GHashTable * (FIXME, generate documentation)</td>
 
8108
</tr>
 
8109
</tbody>
 
8110
</table></div>
 
8111
</div>
7785
8112
</div>
7786
8113
<div class="refsect1">
7787
8114
<a name="telepathy-glib-svc-connection.signal-details"></a><h2>Signal Details</h2>