Top |
TpClientChannelFactoryInterfaceTpClientChannelFactoryInterface — an interface for client channel factories |
TpClientChannelFactory is implemented by TpAutomaticProxyFactory and TpBasicProxyFactory.
Client channel factories are used to create channel proxies. An application wanting to use its own TpChannel subclass has to implement an object implementing the TpClientChannelFactoryInterface interface.
Once a channel has been created by a factory using
tp_client_channel_factory_create_channel()
, the caller should then prepare
on it the channel features returned by
tp_client_channel_factory_dup_channel_features()
using
tp_proxy_prepare_async()
.
TpChannel * tp_client_channel_factory_create_channel (TpClientChannelFactory *self
,TpConnection *conn
,const gchar *path
,GHashTable *properties
,GError **error
);
Function called when a channel need to be created. Implementation can return a subclass of TpChannel if they need to.
Changed in 0.13.6: the function's signature was previously wrong; it expected an object instance as its first parameter, but the type of the parameter was the type of the interface vtable.
self |
a client channel factory |
|
conn |
||
path |
the object path of the channel |
|
properties |
the immutable properties of the channel. |
[transfer none][element-type utf8 GObject.Value] |
error |
used to indicate the error if |
Since: 0.13.2
GArray * tp_client_channel_factory_dup_channel_features (TpClientChannelFactory *self
,TpChannel *channel
);
Return a zero terminated GArray containing the TpChannel features that
should be prepared on channel
.
Changed in 0.13.6: the function's signature was previously wrong; it expected an object instance as its first parameter, but the type of the parameter was the type of the interface vtable.
Since: 0.13.3
typedef struct _TpClientChannelFactory TpClientChannelFactory;
Opaque typedef representing a GObject that implements
the TP_TYPE_CLIENT_CHANNEL_FACTORY
interface.
Since: 0.13.6
struct TpClientChannelFactoryInterface { GTypeInterface parent; TpChannel * (* create_channel) (TpClientChannelFactoryInterface *self, TpConnection *conn, const gchar *path, GHashTable *properties, GError **error); GArray * (* dup_channel_features) (TpClientChannelFactoryInterface *self, TpChannel *channel); TpChannel *(*obj_create_channel) (TpClientChannelFactory *self, TpConnection *conn, const gchar *path, GHashTable *properties, GError **error); GArray *(*obj_dup_channel_features) (TpClientChannelFactory *self, TpChannel *channel); };
Interface for a channel factory
the parent |
||
obsolete version of |
||
obsolete version of |
||
virtual method used to create channels;
see |
||
virtual method returning channel features that
have to be prepared on newly created channels;
see |
Since: 0.13.2