diff options
author | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2008-11-06 17:43:09 +0000 |
---|---|---|
committer | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2008-11-06 17:43:09 +0000 |
commit | e53762999fe18323e25cea47fb7f17c211e579fe (patch) | |
tree | 8c8791851b6f1ea14c23345bcd51a0a28a8e079d /telepathy-glib/connection-handles.c | |
parent | 20418d6289e7d002d1e3bf80c152aa8817148b88 (diff) | |
download | telepathy-glib-e53762999fe18323e25cea47fb7f17c211e579fe.tar.gz |
Warn against using handle-holding D-Bus APIs directly
Diffstat (limited to 'telepathy-glib/connection-handles.c')
-rw-r--r-- | telepathy-glib/connection-handles.c | 11 |
1 files changed, 11 insertions, 0 deletions
diff --git a/telepathy-glib/connection-handles.c b/telepathy-glib/connection-handles.c index 575ee065c..3d8647a05 100644 --- a/telepathy-glib/connection-handles.c +++ b/telepathy-glib/connection-handles.c @@ -268,6 +268,17 @@ _tp_connection_clean_up_handle_refs (TpConnection *self) * Release the reference to the handles in @handles that was obtained by * calling tp_connection_hold_handles() or tp_connection_request_handles(). * + * This function might release any references held by calling + * tp_cli_connection_call_request_handles(), + * tp_cli_connection_run_request_handles(), + * tp_cli_connection_call_hold_handles(), + * tp_cli_connection_run_hold_handles(), + * tp_cli_connection_interface_contacts_call_get_contact_attributes() or + * tp_cli_connection_interface_contacts_run_get_contact_attributes() directly. + * Those functions should be avoided in favour of using #TpContact, + * tp_connection_hold_handles(), tp_connection_request_handles() and + * tp_connection_get_contact_attributes(). + * * If @self has already become invalid, this function does nothing. */ void |