![]() |
![]() |
![]() |
libmcclient Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Signals |
#include <libmcclient/mc-account.h> McAccount; McAccountClass; McAccount * mc_account_new (TpDBusDaemon *dbus, const gchar *object_path); void (*McAccountWhenReadyCb) (McAccount *account, const GError *error, gpointer user_data); void mc_account_call_when_ready (McAccount *account, McAccountWhenReadyCb callback, gpointer user_data); void (*McAccountWhenReadyObjectCb) (McAccount *account, const GError *error, gpointer user_data, GObject *weak_object); void mc_account_call_when_iface_ready (McAccount *account, GQuark interface, McAccountWhenReadyObjectCb callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object); void mc_account_call_when_all_ready (McAccount *account, McAccountWhenReadyObjectCb callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object, ...); const gchar * mc_account_get_display_name (McAccount *account); const gchar * mc_account_get_icon (McAccount *account); gboolean mc_account_is_valid (McAccount *account); gboolean mc_account_is_enabled (McAccount *account); gboolean mc_account_has_been_online (McAccount *account); gboolean mc_account_connects_automatically (McAccount *account); const gchar * mc_account_get_nickname (McAccount *account); GHashTable * mc_account_get_parameters (McAccount *account); void mc_account_get_automatic_presence (McAccount *account, TpConnectionPresenceType *type, const gchar **status, const gchar **message); const gchar * mc_account_get_connection_path (McAccount *account); const gchar * mc_account_get_connection_name (McAccount *account); TpConnectionStatus mc_account_get_connection_status (McAccount *account); TpConnectionStatusReason mc_account_get_connection_status_reason (McAccount *account); void mc_account_get_current_presence (McAccount *account, TpConnectionPresenceType *type, const gchar **status, const gchar **message); void mc_account_get_requested_presence (McAccount *account, TpConnectionPresenceType *type, const gchar **status, const gchar **message); const gchar * mc_account_get_normalized_name (McAccount *account); TpProxyPendingCall * mc_account_set_display_name (McAccount *account, const gchar *display_name, tp_cli_dbus_properties_callback_for_set callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object); TpProxyPendingCall * mc_account_set_icon (McAccount *account, const gchar *icon, tp_cli_dbus_properties_callback_for_set callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object); TpProxyPendingCall * mc_account_set_enabled (McAccount *account, gboolean enabled, tp_cli_dbus_properties_callback_for_set callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object); TpProxyPendingCall * mc_account_set_connect_automatically (McAccount *account, gboolean connect, tp_cli_dbus_properties_callback_for_set callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object); TpProxyPendingCall * mc_account_set_nickname (McAccount *account, const gchar *nickname, tp_cli_dbus_properties_callback_for_set callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object); TpProxyPendingCall * mc_account_set_automatic_presence (McAccount *account, TpConnectionPresenceType type, const gchar *status, const gchar *message, tp_cli_dbus_properties_callback_for_set callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object); TpProxyPendingCall * mc_account_set_requested_presence (McAccount *account, TpConnectionPresenceType type, const gchar *status, const gchar *message, tp_cli_dbus_properties_callback_for_set callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object); void mc_account_avatar_call_when_ready (McAccount *account, McAccountWhenReadyCb callback, gpointer user_data); void mc_account_avatar_get (McAccount *account, const gchar **avatar, gsize *length, const gchar **mime_type); TpProxyPendingCall * mc_account_avatar_set (McAccount *account, const gchar *avatar, gsize len, const gchar *mime_type, tp_cli_dbus_properties_callback_for_set callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object); void mc_account_compat_call_when_ready (McAccount *account, McAccountWhenReadyCb callback, gpointer user_data); const gchar * mc_account_compat_get_profile (McAccount *account); const gchar * mc_account_compat_get_avatar_file (McAccount *account); TpProxyPendingCall * mc_account_compat_set_profile (McAccount *account, const gchar *profile, tp_cli_dbus_properties_callback_for_set callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object); TpProxyPendingCall * mc_account_compat_set_secondary_vcard_fields (McAccount *account, const gchar * const *fields, tp_cli_dbus_properties_callback_for_set callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object); void mc_account_conditions_call_when_ready (McAccount *account, McAccountWhenReadyCb callback, gpointer user_data); GHashTable * mc_account_conditions_get (McAccount *account); TpProxyPendingCall * mc_account_conditions_set (McAccount *account, const GHashTable *conditions, tp_cli_dbus_properties_callback_for_set callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object); McAccountChannelrequestData; enum McAccountChannelrequestEvent; void (*McAccountChannelrequestCb) (McAccount *account, guint request_id, McAccountChannelrequestEvent event, gpointer user_data, GObject *weak_object); enum McAccountChannelrequestFlags; guint mc_account_channelrequest (McAccount *account, const McAccountChannelrequestData *req_data, time_t user_action_time, const gchar *handler, McAccountChannelrequestFlags flags, McAccountChannelrequestCb callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object); guint mc_account_channelrequest_ht (McAccount *account, GHashTable *properties, time_t user_action_time, const gchar *handler, McAccountChannelrequestFlags flags, McAccountChannelrequestCb callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object); guint mc_account_channelrequest_add (McAccount *account, const gchar *object_path, GHashTable *properties, McAccountChannelrequestCb callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object); void mc_account_channelrequest_cancel (McAccount *account, guint request_id); const GError * mc_account_channelrequest_get_error (McAccount *account, guint request_id); const gchar * mc_account_channelrequest_get_path (McAccount *account, guint request_id); guint mc_account_channelrequest_get_from_path (McAccount *account, const gchar *object_path); void (*mc_cli_account_signal_callback_removed) (TpProxy *proxy, gpointer user_data, GObject *weak_object); TpProxySignalConnection * mc_cli_account_connect_to_removed (gpointer proxy, mc_cli_account_signal_callback_removed callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object, GError **error); void (*mc_cli_account_signal_callback_account_property_changed) (TpProxy *proxy, GHashTable *arg_Properties, gpointer user_data, GObject *weak_object); TpProxySignalConnection * mc_cli_account_connect_to_account_property_changed (gpointer proxy, mc_cli_account_signal_callback_account_property_changed callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object, GError **error); void (*mc_cli_account_callback_for_remove) (TpProxy *proxy, const GError *error, gpointer user_data, GObject *weak_object); TpProxyPendingCall * mc_cli_account_call_remove (gpointer proxy, gint timeout_ms, mc_cli_account_callback_for_remove callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object); void (*mc_cli_account_callback_for_update_parameters) (TpProxy *proxy, const gchar **out_Reconnect_Required, const GError *error, gpointer user_data, GObject *weak_object); TpProxyPendingCall * mc_cli_account_call_update_parameters (gpointer proxy, gint timeout_ms, GHashTable *in_Set, const gchar **in_Unset, mc_cli_account_callback_for_update_parameters callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object); void (*mc_cli_account_interface_avatar_signal_callback_avatar_changed) (TpProxy *proxy, gpointer user_data, GObject *weak_object); TpProxySignalConnection * mc_cli_account_interface_avatar_connect_to_avatar_changed (gpointer proxy, mc_cli_account_interface_avatar_signal_callback_avatar_changed callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object, GError **error);
"avatar-changed" : Run Last / Has Details "channel-count-changed" : Run Last "connection-status-changed" : Run Last "flag-changed" : Run Last / Has Details "parameters-changed" : Run Last / Has Details "presence-changed" : Run Last / Has Details "string-changed" : Run Last / Has Details
typedef struct { TpProxy parent; gchar *name; gchar *manager_name; gchar *protocol_name; } McAccount;
A proxy object for the Telepathy Account D-Bus API. This is a subclass of TpProxy.
McAccount * mc_account_new (TpDBusDaemon *dbus, const gchar *object_path);
|
a D-Bus daemon; may not be NULL
|
|
the path of the D-Bus account object. |
Returns : |
a new McAccount object. |
void (*McAccountWhenReadyCb) (McAccount *account, const GError *error, gpointer user_data);
|
the McAccount. |
|
NULL if the interface is ready for use, or the error with which it
was invalidated if it is now invalid.
|
|
the user data that was passed to mc_account_call_when_ready() .
|
void mc_account_call_when_ready (McAccount *account, McAccountWhenReadyCb callback, gpointer user_data);
Start retrieving and monitoring the properties of the base interface of
account
. If they have already been retrieved, call callback
immediately,
then return. Otherwise, callback
will be called when the properties are
ready.
|
the McAccount. |
|
called when the interface becomes ready or invalidated, whichever happens first. |
|
user data to be passed to callback .
|
void (*McAccountWhenReadyObjectCb) (McAccount *account, const GError *error, gpointer user_data, GObject *weak_object);
|
the McAccount. |
|
NULL if the interface is ready for use, or the error with which it
was invalidated if it is now invalid.
|
|
the user data that was passed to
mc_account_call_when_iface_ready() or mc_account_call_when_all_ready() .
|
|
the GObject that was passed to
mc_account_call_when_iface_ready() or mc_account_call_when_all_ready() .
|
void mc_account_call_when_iface_ready (McAccount *account, GQuark interface, McAccountWhenReadyObjectCb callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object);
Start retrieving and monitoring the properties of the interface interface
of account
. If they have already been retrieved, call callback
immediately, then return. Otherwise, callback
will be called when the
properties are ready.
|
the McAccount. |
|
a GQuark representing the interface to process. |
|
called when the interface becomes ready or invalidated, whichever happens first. |
|
user data to be passed to callback .
|
|
called with the user_data as argument, after the call has succeeded, failed or been cancelled. |
|
If not NULL , a GObject which will be weakly referenced; if
it is destroyed, this call will automatically be cancelled. Must be NULL if
callback is NULL
|
void mc_account_call_when_all_ready (McAccount *account, McAccountWhenReadyObjectCb callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object, ...);
Start retrieving and monitoring the properties of the specified interfaces
of account
. This is a convenience function built around
mc_account_call_when_iface_ready()
, to have callback
called only once all
the specified interfaces are ready. In case more than one interface fail to
be processed, the GError passed to the callback function will be the one of
the first interface that failed.
|
the McAccount. |
|
called when the interfaces becomes ready or invalidated, whichever happens first. |
|
user data to be passed to callback .
|
|
called with the user_data as argument, after the call has succeeded, failed or been cancelled. |
|
If not NULL , a GObject which will be weakly referenced; if
it is destroyed, this call will automatically be cancelled. Must be NULL if
callback is NULL
|
|
a list of GQuark types representing the interfaces to process,
followed by 0 .
|
const gchar * mc_account_get_display_name (McAccount *account);
|
the McAccount. |
Returns : |
a constant string representing the account display name.
mc_account_call_when_ready() must have been successfully invoked prior to
calling this function.
|
const gchar * mc_account_get_icon (McAccount *account);
|
the McAccount. |
Returns : |
a constant string representing the account icon name.
mc_account_call_when_ready() must have been successfully invoked prior to
calling this function.
|
gboolean mc_account_is_valid (McAccount *account);
|
the McAccount. |
Returns : |
TRUE if the account is valid, FALSE otherwise.
mc_account_call_when_ready() must have been successfully invoked prior to
calling this function.
|
gboolean mc_account_is_enabled (McAccount *account);
|
the McAccount. |
Returns : |
TRUE if the account is enabled, FALSE otherwise.
mc_account_call_when_ready() must have been successfully invoked prior to
calling this function.
|
gboolean mc_account_has_been_online (McAccount *account);
|
the McAccount. |
Returns : |
TRUE if the account has ever been online, FALSE otherwise.
mc_account_call_when_ready() must have been successfully invoked prior to
calling this function.
|
gboolean mc_account_connects_automatically (McAccount *account);
|
the McAccount. |
Returns : |
TRUE if the account automatically connects when possible, FALSE
otherwise.
mc_account_call_when_ready() must have been successfully invoked prior to
calling this function.
|
const gchar * mc_account_get_nickname (McAccount *account);
|
the McAccount. |
Returns : |
the nickname (alias) of account .
mc_account_call_when_ready() must have been successfully invoked prior to
calling this function.
|
GHashTable * mc_account_get_parameters (McAccount *account);
|
the McAccount. |
Returns : |
a constant GHashTable (do not destroy or modify it) listing the
account parameters. The keys in the hash table are strings representing the
parameter names, and the values are stored in GValue types.
mc_account_call_when_ready() must have been successfully invoked prior to
calling this function.
|
void mc_account_get_automatic_presence (McAccount *account, TpConnectionPresenceType *type, const gchar **status, const gchar **message);
Retrieves the automatic presence (the presence this account will request
when going automatically online).
mc_account_call_when_ready()
must have been successfully invoked prior to
calling this function.
|
the McAccount. |
|
pointer to a TpConnectionPresenceType to receive the presence type. |
|
pointer that will receive the presence status string (to be not modified or free'd). |
|
pointer that will receive the presence status message string (to be not modified or free'd). |
const gchar * mc_account_get_connection_path (McAccount *account);
|
the McAccount. |
Returns : |
a constant string representing the D-Bus path of the Telepathy
connection object, or NULL if the account is disconnected.
mc_account_call_when_ready() must have been successfully invoked prior to
calling this function.
|
const gchar * mc_account_get_connection_name (McAccount *account);
deprecated
: use mc_account_get_connection_path()
instead.
|
the McAccount. |
Returns : |
TpConnectionStatus mc_account_get_connection_status (McAccount *account);
|
the McAccount. |
Returns : |
the connection status of the Telepathy connection object.
mc_account_call_when_ready() must have been successfully invoked prior to
calling this function.
|
TpConnectionStatusReason mc_account_get_connection_status_reason (McAccount *account);
|
the McAccount. |
Returns : |
the connection status reason of the Telepathy connection object.
mc_account_call_when_ready() must have been successfully invoked prior to
calling this function.
|
void mc_account_get_current_presence (McAccount *account, TpConnectionPresenceType *type, const gchar **status, const gchar **message);
Retrieves the current presence of account
.
mc_account_call_when_ready()
must have been successfully invoked prior to
calling this function.
|
the McAccount. |
|
pointer to a TpConnectionPresenceType to receive the presence type. |
|
pointer that will receive the presence status string (to be not modified or free'd). |
|
pointer that will receive the presence status message string (to be not modified or free'd). |
void mc_account_get_requested_presence (McAccount *account, TpConnectionPresenceType *type, const gchar **status, const gchar **message);
Retrieves the requested presence of account
.
mc_account_call_when_ready()
must have been successfully invoked prior to
calling this function.
|
the McAccount. |
|
pointer to a TpConnectionPresenceType to receive the presence type. |
|
pointer that will receive the presence status string (to be not modified or free'd). |
|
pointer that will receive the presence status message string (to be not modified or free'd). |
const gchar * mc_account_get_normalized_name (McAccount *account);
|
the McAccount. |
Returns : |
a constant string representing the normalized name of account .
This is the value returned from Telepathy when inspecting the self handle,
and will be NULL if the account never went online.
connection object, or NULL if the account is disconnected.
mc_account_call_when_ready() must have been successfully invoked prior to
calling this function.
|
TpProxyPendingCall * mc_account_set_display_name (McAccount *account, const gchar *display_name, tp_cli_dbus_properties_callback_for_set callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object);
Set the display name of account
.
|
the McAccount. |
|
display name to be set. |
|
callback to be invoked when the operation completes, or NULL .
|
|
user data for callback .
|
|
GDestroyNotify function for user_data .
|
|
if not NULL, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be NULL if callback is NULL. |
Returns : |
a TpProxyPendingCall for the underlying D-Bus call. |
TpProxyPendingCall * mc_account_set_icon (McAccount *account, const gchar *icon, tp_cli_dbus_properties_callback_for_set callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object);
Set the icon of account
.
|
the McAccount. |
|
icon name to be set. |
|
callback to be invoked when the operation completes, or NULL .
|
|
user data for callback .
|
|
GDestroyNotify function for user_data .
|
|
if not NULL, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be NULL if callback is NULL. |
Returns : |
a TpProxyPendingCall for the underlying D-Bus call. |
TpProxyPendingCall * mc_account_set_enabled (McAccount *account, gboolean enabled, tp_cli_dbus_properties_callback_for_set callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object);
Enables or disables account
.
|
the McAccount. |
|
whether the account must be enabled.
|
|
callback to be invoked when the operation completes, or NULL .
|
|
user data for callback .
|
|
GDestroyNotify function for user_data .
|
|
if not NULL, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be NULL if callback is NULL. |
Returns : |
a TpProxyPendingCall for the underlying D-Bus call. |
TpProxyPendingCall * mc_account_set_connect_automatically (McAccount *account, gboolean connect, tp_cli_dbus_properties_callback_for_set callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object);
Enables or disables automatic connection for account
.
|
the McAccount. |
|
whether the account must connect automatically.
|
|
callback to be invoked when the operation completes, or NULL .
|
|
user data for callback .
|
|
GDestroyNotify function for user_data .
|
|
if not NULL, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be NULL if callback is NULL. |
Returns : |
a TpProxyPendingCall for the underlying D-Bus call. |
TpProxyPendingCall * mc_account_set_nickname (McAccount *account, const gchar *nickname, tp_cli_dbus_properties_callback_for_set callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object);
Set the nickname (alias) of account
.
|
the McAccount. |
|
nickname to be set. |
|
callback to be invoked when the operation completes, or NULL .
|
|
user data for callback .
|
|
GDestroyNotify function for user_data .
|
|
if not NULL, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be NULL if callback is NULL. |
Returns : |
a TpProxyPendingCall for the underlying D-Bus call. |
TpProxyPendingCall * mc_account_set_automatic_presence (McAccount *account, TpConnectionPresenceType type, const gchar *status, const gchar *message, tp_cli_dbus_properties_callback_for_set callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object);
Set the automatic presence of account
.
|
the McAccount. |
|
the presence type. |
|
the presence status string. |
|
the presence status message. |
|
callback to be invoked when the operation completes, or NULL .
|
|
user data for callback .
|
|
GDestroyNotify function for user_data .
|
|
if not NULL, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be NULL if callback is NULL. |
Returns : |
a TpProxyPendingCall for the underlying D-Bus call. |
TpProxyPendingCall * mc_account_set_requested_presence (McAccount *account, TpConnectionPresenceType type, const gchar *status, const gchar *message, tp_cli_dbus_properties_callback_for_set callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object);
Set the requested presence of account
.
|
the McAccount. |
|
the presence type. |
|
the presence status string. |
|
the presence status message. |
|
callback to be invoked when the operation completes, or NULL .
|
|
user data for callback .
|
|
GDestroyNotify function for user_data .
|
|
if not NULL, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be NULL if callback is NULL. |
Returns : |
a TpProxyPendingCall for the underlying D-Bus call. |
void mc_account_avatar_call_when_ready (McAccount *account, McAccountWhenReadyCb callback, gpointer user_data);
Start retrieving and monitoring the properties of the Avatar interface of
account
. If they have already been retrieved, call callback
immediately,
then return. Otherwise, callback
will be called when the properties are
ready.
|
the McAccount. |
|
called when the interface becomes ready or invalidated, whichever happens first. |
|
user data to be passed to callback .
|
void mc_account_avatar_get (McAccount *account, const gchar **avatar, gsize *length, const gchar **mime_type);
Retrieves the avatar file contents and MIME type.
mc_account_avatar_call_when_ready()
must have been successfully invoked
prior to calling this function.
|
the McAccount. |
|
|
|
|
|
TpProxyPendingCall * mc_account_avatar_set (McAccount *account, const gchar *avatar, gsize len, const gchar *mime_type, tp_cli_dbus_properties_callback_for_set callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object);
Set the secondary VCard fields for account
.
|
the McAccount. |
|
|
|
|
|
|
|
callback to be invoked when the operation completes, or NULL .
|
|
user data for callback .
|
|
GDestroyNotify function for user_data .
|
|
if not NULL, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be NULL if callback is NULL. |
Returns : |
a TpProxyPendingCall for the underlying D-Bus call. |
void mc_account_compat_call_when_ready (McAccount *account, McAccountWhenReadyCb callback, gpointer user_data);
Start retrieving and monitoring the properties of the Compat interface of
account
. If they have already been retrieved, call callback
immediately,
then return. Otherwise, callback
will be called when the properties are
ready.
|
the McAccount. |
|
called when the interface becomes ready or invalidated, whichever happens first. |
|
user data to be passed to callback .
|
const gchar * mc_account_compat_get_profile (McAccount *account);
Retrieves the profile name of account
.
|
the McAccount. |
Returns : |
a constant string representing the name of the profile. |
const gchar * mc_account_compat_get_avatar_file (McAccount *account);
|
the McAccount. |
Returns : |
a constant string representing the filename of the avatar. |
TpProxyPendingCall * mc_account_compat_set_profile (McAccount *account, const gchar *profile, tp_cli_dbus_properties_callback_for_set callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object);
|
|
|
|
|
|
|
|
|
|
|
|
Returns : |
TpProxyPendingCall * mc_account_compat_set_secondary_vcard_fields (McAccount *account, const gchar * const *fields, tp_cli_dbus_properties_callback_for_set callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object);
|
|
|
|
|
|
|
|
|
|
|
|
Returns : |
void mc_account_conditions_call_when_ready (McAccount *account, McAccountWhenReadyCb callback, gpointer user_data);
Start retrieving and monitoring the properties of the Conditions interface
of account
. If they have already been retrieved, call callback
immediately, then return. Otherwise, callback
will be called when the
properties are ready.
|
the McAccount. |
|
called when the interface becomes ready or invalidated, whichever happens first. |
|
user data to be passed to callback .
|
GHashTable * mc_account_conditions_get (McAccount *account);
Retrieves the account conditions.
|
the McAccount. |
Returns : |
a GHashTable containing the account conditions, where both keys and values are NULL-terminated strings. It must not be modified or destroyed. |
TpProxyPendingCall * mc_account_conditions_set (McAccount *account, const GHashTable *conditions, tp_cli_dbus_properties_callback_for_set callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object);
Set the conditions for account
; the conditions
must be in a GHashTable
where both keys and valus are NULL-terminated strings. It will not be
modified by this method.
|
the McAccount. |
|
a GHashTable with the conditions to set. |
|
callback to be invoked when the operation completes, or NULL .
|
|
user data for callback .
|
|
GDestroyNotify function for user_data .
|
|
if not NULL, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be NULL if callback is NULL. |
Returns : |
a TpProxyPendingCall for the underlying D-Bus call. |
typedef struct { guint32 _mask; GQuark fld_channel_type; guint fld_target_handle; TpHandleType fld_target_handle_type; const gchar *fld_target_id; } McAccountChannelrequestData;
typedef enum { MC_ACCOUNT_CR_SUCCEEDED, MC_ACCOUNT_CR_FAILED, MC_ACCOUNT_CR_CANCELLED, } McAccountChannelrequestEvent;
void (*McAccountChannelrequestCb) (McAccount *account, guint request_id, McAccountChannelrequestEvent event, gpointer user_data, GObject *weak_object);
This callback will be called when some event occurs on the channel request.
If the event is one of MC_ACCOUNT_CR_SUCCEEDED
, MC_ACCOUNT_CR_FAILED
or
MC_ACCOUNT_CR_CANCELLED
, the channel request should be considered
completed, and request_id
will be no longer valid.
This callback could be called multiple times, in case some other events than
MC_ACCOUNT_CR_SUCCEEDED
, MC_ACCOUNT_CR_FAILED
and MC_ACCOUNT_CR_CANCELLED
occur.
|
the McAccount. |
|
unique identifier of the channel request. |
|
one McAccountChannelrequestEvent. |
|
the user data that was passed when registering the callback. |
|
the GObject that was passed when registering the callback. |
typedef enum { MC_ACCOUNT_CR_FLAG_USE_EXISTING = 1 << 0, /* if set, call EnsureChannel */ } McAccountChannelrequestFlags;
guint mc_account_channelrequest (McAccount *account, const McAccountChannelrequestData *req_data, time_t user_action_time, const gchar *handler, McAccountChannelrequestFlags flags, McAccountChannelrequestCb callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object);
This is a convenience function that internally calls
mc_account_channelrequest_ht()
. The only difference between the two
functions is that this one takes the requested properties in the form of a
McAccountChannelrequestData structure.
|
the McAccount. |
|
a McAccountChannelrequestData struct with the requested fields set. |
|
the time at which user action occurred, or 0 .
|
|
well-known name of the preferred handler, or NULL .
|
|
a combination of McAccountChannelrequestFlags. |
|
called when something happens to the request. |
|
user data to be passed to callback .
|
|
called with the user_data as argument, after the request has succeeded, failed or been cancelled. |
|
If not NULL , a GObject which will be weakly referenced; if
it is destroyed, this call will automatically be cancelled.
|
Returns : |
the unique ID of the channel request. |
guint mc_account_channelrequest_ht (McAccount *account, GHashTable *properties, time_t user_action_time, const gchar *handler, McAccountChannelrequestFlags flags, McAccountChannelrequestCb callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object);
Requests a channel matching all the requested properties
. The channel
request is uniquely identified (inside the process that called this method)
by an unsigned integer ID, which is the return value of the method and also
the second parameter passed to callback
.
Unless the weak_object
is destroyed, callback
will be called to notify the
requestor of the progress of its request. The only events supported so far
are MC_ACCOUNT_CR_SUCCEEDED
, MC_ACCOUNT_CR_FAILED
and
MC_ACCOUNT_CR_CANCELLED
, which also happen to signal the end of the request:
after one of these events occur, the request ID is no longer valid, and
destroy
(if it was not NULL
) is called on user_data
.
If the weak_object
is destroyed before the channel request is completed,
callback
will not be called anymore, but destroy
(if it was not NULL
) is
called on user_data
; the channel request is left at whatever state it was:
if you want it to be cancelled, you need to call
mc_account_channelrequest_cancel()
explicitly.
|
the McAccount. |
|
a GHashTable with the requested channel properties. |
|
the time at which user action occurred, or 0 .
|
|
well-known name of the preferred handler, or NULL .
|
|
a combination of McAccountChannelrequestFlags. |
|
called when something happens to the request. |
|
user data to be passed to callback .
|
|
called with the user_data as argument, after the request has succeeded, failed or been cancelled. |
|
If not NULL , a GObject which will be weakly referenced; if
it is destroyed, this call will automatically be cancelled.
|
Returns : |
the unique ID of the channel request. |
guint mc_account_channelrequest_add (McAccount *account, const gchar *object_path, GHashTable *properties, McAccountChannelrequestCb callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object);
This function adds an existing request, created from another process and
described by object_path
and properties
, to those to be monitored.
|
the McAccount. |
|
the D-Bus object path of a channel request. |
|
a D-Bus a{sv} of properties. |
|
called when something happens to the request. |
|
user data to be passed to callback .
|
|
called with the user_data as argument, after the request has succeeded, failed or been cancelled. |
|
If not NULL , a GObject which will be weakly referenced; if
it is destroyed, this call will automatically be cancelled.
|
Returns : |
the unique ID of the channel request, or 0 if the request was
already being monitored by another callback.
|
void mc_account_channelrequest_cancel (McAccount *account, guint request_id);
Cancel the channel request identified by request_id
.
|
the McAccount. |
|
the ID of the request to be cancelled. |
const GError * mc_account_channelrequest_get_error (McAccount *account, guint request_id);
Get the last error which occurred on the channel request identified by
request_id
.
const gchar * mc_account_channelrequest_get_path (McAccount *account, guint request_id);
Get the object path of the channel request identified by request_id
.
The channel request D-Bus object is currently not implemented, but this
object path can be used consistently with the
org.freedesktop.Telepathy.Client.Handler interface.
|
the McAccount. |
|
the ID of the channel request. |
Returns : |
the object path of the channel request. |
guint mc_account_channelrequest_get_from_path (McAccount *account, const gchar *object_path);
Finds the request ID whose D-Bus object path matches object_path
.
This only works if the request was created by this process.
|
the McAccount. |
|
the D-Bus object path of a channel request. |
Returns : |
the unique ID of the channel request, or 0 .
|
void (*mc_cli_account_signal_callback_removed) (TpProxy *proxy, gpointer user_data, GObject *weak_object);
Represents the signature of a callback for the signal Removed.
|
The proxy on which mc_cli_account_connect_to_removed()
was called
|
|
User-supplied data |
|
User-supplied weakly referenced object |
TpProxySignalConnection * mc_cli_account_connect_to_removed (gpointer proxy, mc_cli_account_signal_callback_removed callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object, GError **error);
Connect a handler to the signal Removed.
This account has been removed. <tp:rationale> This is redundant with <tp:dbus-ref namespace="org.freedesktop.Telepathy.AccountManager">AccountRemoved</tp:dbus-ref>, but it's still worth having, to avoid having to bind to AccountManager.AccountRemoved to tell you whether your Account is valid — ideally, an account-editing UI should only care about a single Account. </tp:rationale>
|
A TpProxy or subclass |
|
Callback to be called when the signal is received |
|
User-supplied data for the callback |
|
Destructor for the user-supplied data, which
will be called when this signal is disconnected, or
before this function returns NULL
|
|
A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected |
|
If not NULL , used to raise an error if NULL is
returned
|
Returns : |
a TpProxySignalConnection containing all of the
above, which can be used to disconnect the signal; or
NULL if the proxy does not have the desired interface
or has become invalid.
|
void (*mc_cli_account_signal_callback_account_property_changed) (TpProxy *proxy, GHashTable *arg_Properties, gpointer user_data, GObject *weak_object);
Represents the signature of a callback for the signal AccountPropertyChanged.
|
The proxy on which mc_cli_account_connect_to_account_property_changed()
was called
|
|
A map from property names in this namespace (e.g. <tp:member-ref>Nickname</tp:member-ref>) to values. Properties whose values have not changed SHOULD be omitted, but this need not be done. |
|
User-supplied data |
|
User-supplied weakly referenced object |
TpProxySignalConnection * mc_cli_account_connect_to_account_property_changed (gpointer proxy, mc_cli_account_signal_callback_account_property_changed callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object, GError **error);
Connect a handler to the signal AccountPropertyChanged.
The values of one or more properties on this interface (that do not specify that this signal does not apply to them) may have changed. This does not cover properties of other interfaces, which must provide their own change notification if appropriate.
|
A TpProxy or subclass |
|
Callback to be called when the signal is received |
|
User-supplied data for the callback |
|
Destructor for the user-supplied data, which
will be called when this signal is disconnected, or
before this function returns NULL
|
|
A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected |
|
If not NULL , used to raise an error if NULL is
returned
|
Returns : |
a TpProxySignalConnection containing all of the
above, which can be used to disconnect the signal; or
NULL if the proxy does not have the desired interface
or has become invalid.
|
void (*mc_cli_account_callback_for_remove) (TpProxy *proxy, const GError *error, gpointer user_data, GObject *weak_object);
Signature of the callback called when a Remove method call succeeds or fails.
|
the proxy on which the call was made |
|
NULL on success, or an error on failure
|
|
user-supplied data |
|
user-supplied object |
TpProxyPendingCall * mc_cli_account_call_remove (gpointer proxy, gint timeout_ms, mc_cli_account_callback_for_remove callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object);
Start a Remove method call.
Delete the account.
|
the TpProxy |
|
the timeout in milliseconds, or -1 to use the default |
|
called when the method call succeeds or fails;
may be NULL to make a "fire and forget" call with no
reply tracking
|
|
user-supplied data passed to the callback;
must be NULL if callback is NULL
|
|
called with the user_data as argument, after the
call has succeeded, failed or been cancelled;
must be NULL if callback is NULL
|
|
If not NULL , a GObject which will be
weakly referenced; if it is destroyed, this call
will automatically be cancelled. Must be NULL if
callback is NULL
|
Returns : |
a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid. |
void (*mc_cli_account_callback_for_update_parameters) (TpProxy *proxy, const gchar **out_Reconnect_Required, const GError *error, gpointer user_data, GObject *weak_object);
Signature of the callback called when a UpdateParameters method call succeeds or fails.
|
the proxy on which the call was made |
|
Used to return an 'out' argument if error is NULL : A list of the names of parameters with changes that will not take effect until the account is reconnected (this may be empty, e.g. if all the parameters are D-Bus properties or parameters for which the account manager has specific support). User interfaces that require "instant apply" semantics MAY call <tp:member-ref>Reconnect</tp:member-ref> in response to receiving a non-empty list.
|
|
NULL on success, or an error on failure
|
|
user-supplied data |
|
user-supplied object |
TpProxyPendingCall * mc_cli_account_call_update_parameters (gpointer proxy, gint timeout_ms, GHashTable *in_Set, const gchar **in_Unset, mc_cli_account_callback_for_update_parameters callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object);
Start a UpdateParameters method call.
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Change the value of the <tp:member-ref>Parameters</tp:member-ref> property.</p> <p>If any of the changed parameters' <tp:type>Conn_Mgr_Param_Flags</tp:type> include <code>DBus_Property</code>, the change will be applied to the corresponding D-Bus Property on the active <tp:member-ref>Connection</tp:member-ref>, if there is one. Changes to other parameters will not take effect until the next time the account is disconnected and reconnected.</p> <tp:rationale> <p>In general, reconnecting is a destructive operation that shouldn't happen as a side-effect. In particular, migration tools that twiddle the settings of all accounts shouldn't cause an automatic disconnect and reconnect.</p> </tp:rationale>
|
the TpProxy |
|
the timeout in milliseconds, or -1 to use the default |
|
Used to pass an 'in' argument: A mapping from parameter names to their values. These parameters should be stored for future use. |
|
Used to pass an 'in' argument: A list of the names of parameters to be removed from the set of stored values, allowing the default values to be used. If the given parameters were not, in fact, stored, or even if they do not exist at all, the account manager MUST accept this without error. |
|
called when the method call succeeds or fails;
may be NULL to make a "fire and forget" call with no
reply tracking
|
|
user-supplied data passed to the callback;
must be NULL if callback is NULL
|
|
called with the user_data as argument, after the
call has succeeded, failed or been cancelled;
must be NULL if callback is NULL
|
|
If not NULL , a GObject which will be
weakly referenced; if it is destroyed, this call
will automatically be cancelled. Must be NULL if
callback is NULL
|
Returns : |
a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid. |
void (*mc_cli_account_interface_avatar_signal_callback_avatar_changed) (TpProxy *proxy, gpointer user_data, GObject *weak_object);
Represents the signature of a callback for the signal AvatarChanged.
|
The proxy on which mc_cli_account_interface_avatar_connect_to_avatar_changed()
was called
|
|
User-supplied data |
|
User-supplied weakly referenced object |
TpProxySignalConnection * mc_cli_account_interface_avatar_connect_to_avatar_changed (gpointer proxy, mc_cli_account_interface_avatar_signal_callback_avatar_changed callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object, GError **error);
Connect a handler to the signal AvatarChanged.
Emitted when the Avatar property changes. <tp:rationale>The avatar itself is deliberately not included in this signal, to reduce bus traffic in the (likely common) case where no running application cares about the user's own avatar.</tp:rationale>
|
A TpProxy or subclass |
|
Callback to be called when the signal is received |
|
User-supplied data for the callback |
|
Destructor for the user-supplied data, which
will be called when this signal is disconnected, or
before this function returns NULL
|
|
A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected |
|
If not NULL , used to raise an error if NULL is
returned
|
Returns : |
a TpProxySignalConnection containing all of the
above, which can be used to disconnect the signal; or
NULL if the proxy does not have the desired interface
or has become invalid.
|
"avatar-changed"
signalvoid user_function (McAccount *account, GArray_guchar_ *avatar, gchar *mime_type, gpointer user_data) : Run Last / Has Details
Emitted when the avatar changes.
This signal will be emitted only once
mc_account_avatar_call_when_ready()
has been successfully invoked.
"channel-count-changed"
signalvoid user_function (McAccount *account, GHashTable *channel_count, gpointer user_data) : Run Last
Emitted when the stats changes.
The McAccount member data are updated in the signal closure, so use
g_signal_connect_after()
if you need them to reflect the new status.
|
the McAccount. |
|
a GHashTable with the new channel counters. |
|
user data set when the signal handler was connected. |
"connection-status-changed"
signalvoid user_function (McAccount *mcaccount, guint arg1, guint arg2, gpointer user_data) : Run Last
|
the object which received the signal. |
|
|
|
|
|
user data set when the signal handler was connected. |
"flag-changed"
signalvoid user_function (McAccount *account, guint detail, gboolean value, gpointer user_data) : Run Last / Has Details
Emitted when a boolean property changes (such as valid, enabled).
This signal will be emitted only once mc_account_call_when_ready()
has
been successfully invoked.
"parameters-changed"
signalvoid user_function (McAccount *account, GHashTable *old, GHashTable *new, gpointer user_data) : Run Last / Has Details
Emitted when the account parameters change. Don't modify the passed-in hash tables.
This signal will be emitted only once mc_account_call_when_ready()
has
been successfully invoked.
|
the McAccount. |
|
the GHashTable of the old account parameters. |
|
the GHashTable of the new account parameters. |
|
user data set when the signal handler was connected. |
"presence-changed"
signalvoid user_function (McAccount *account, guint detail, guint type, gchar *status, gchar *message, gpointer user_data) : Run Last / Has Details
Emitted when the current, requested or automatic presence changes.
This signal will be emitted only once mc_account_call_when_ready()
has
been successfully invoked.
"string-changed"
signalvoid user_function (McAccount *account, guint status, gchar *reason, gpointer user_data) : Run Last / Has Details
Emitted when the connection status changes.
This signal will be emitted only once mc_account_call_when_ready()
has
been successfully invoked.
|
the McAccount. |
|
the connection status. |
|
the connection status reason. |
|
user data set when the signal handler was connected. |