![]() |
![]() |
![]() |
telepathy-glib API Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
Connection ClientTypes interfaceConnection ClientTypes interface — client-side wrappers for the ClientTypes interface |
#include <telepathy-glib/telepathy-glib-dbus.h> TpProxyPendingCall * tp_cli_connection_interface_client_types1_call_request_client_types (TpConnection *proxy
,gint timeout_ms
,guint in_Contact
,tp_cli_connection_interface_client_types1_callback_for_request_client_types callback
,gpointer user_data
,GDestroyNotify destroy
,GObject *weak_object
); void (*tp_cli_connection_interface_client_types1_callback_for_request_client_types) (TpConnection *proxy
,const gchar **out_Client_Types
,const GError *error
,gpointer user_data
,GObject *weak_object
); TpProxySignalConnection * tp_cli_connection_interface_client_types1_connect_to_client_types_updated (TpConnection *proxy
,tp_cli_connection_interface_client_types1_signal_callback_client_types_updated callback
,gpointer user_data
,GDestroyNotify destroy
,GObject *weak_object
,GError **error
); void (*tp_cli_connection_interface_client_types1_signal_callback_client_types_updated) (TpConnection *proxy
,guint arg_Contact
,const gchar **arg_Client_Types
,gpointer user_data
,GObject *weak_object
);
On some protocols it's possible to determine the type of client another user is using, ranging from a simple "phone or not?" indicator to a classification into several types of user interface. Telepathy represents these using the client types defined by XMPP.
This section documents the auto-generated C wrappers for the ClientTypes interface, used with TpConnection objects.
TpProxyPendingCall * tp_cli_connection_interface_client_types1_call_request_client_types (TpConnection *proxy
,gint timeout_ms
,guint in_Contact
,tp_cli_connection_interface_client_types1_callback_for_request_client_types callback
,gpointer user_data
,GDestroyNotify destroy
,GObject *weak_object
);
Start a RequestClientTypes method call.
Return the current client types of the given contact. If necessary, make a request to the server for up-to-date information, and wait for a reply. <tp:rationale> This method is appropriate for use in a "Contact Information..." dialog; it can be used to show progress information (while waiting for the method to return), and can distinguish between various error conditions. </tp:rationale>
|
the TpProxy |
|
the timeout in milliseconds, or -1 to use the default |
|
Used to pass an 'in' argument: The contact whose client types should be returned. (TpContactHandle) |
|
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 (*tp_cli_connection_interface_client_types1_callback_for_request_client_types) (TpConnection *proxy
,const gchar **out_Client_Types
,const GError *error
,gpointer user_data
,GObject *weak_object
);
Signature of the callback called when a RequestClientTypes method call succeeds or fails.
|
the proxy on which the call was made |
|
Used to return an 'out' argument if error is NULL : The contact's client types. It MAY be empty, indicating that no client type information was found. |
|
NULL on success, or an error on failure |
|
user-supplied data |
|
user-supplied object |
TpProxySignalConnection * tp_cli_connection_interface_client_types1_connect_to_client_types_updated (TpConnection *proxy
,tp_cli_connection_interface_client_types1_signal_callback_client_types_updated callback
,gpointer user_data
,GDestroyNotify destroy
,GObject *weak_object
,GError **error
);
Connect a handler to the signal ClientTypesUpdated.
Emitted when a contact's client types change or become known.
|
A TpConnection 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 (*tp_cli_connection_interface_client_types1_signal_callback_client_types_updated) (TpConnection *proxy
,guint arg_Contact
,const gchar **arg_Client_Types
,gpointer user_data
,GObject *weak_object
);
Represents the signature of a callback for the signal ClientTypesUpdated.
|
The proxy on which tp_cli_connection_interface_client_types1_connect_to_client_types_updated()
was called |
|
The contact. (TpContactHandle) |
|
The contact's client types, or an empty list to indicate that nothing is known about the contact's client types. |
|
User-supplied data |
|
User-supplied weakly referenced object |