![]() |
![]() |
![]() |
telepathy-glib API Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
TpClientChannelFactoryInterfaceTpClientChannelFactoryInterface — an interface for client channel factories |
#include <telepathy-glib/client-channel-factory.h> TpClientChannelFactoryInterface; TpChannel * tp_client_channel_factory_create_channel (TpClientChannelFactoryInterface *self
,TpConnection *conn
,const gchar *path
,GHashTable *properties
,GError **error
); GArray * tp_client_channel_factory_dup_channel_features (TpClientChannelFactoryInterface *self
,TpChannel *channel
);
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()
.
typedef struct { GTypeInterface parent; TpChannel * (* create_channel) (TpClientChannelFactoryInterface *self, TpConnection *conn, const gchar *path, GHashTable *properties, GError **error); GArray * (* dup_channel_features) (TpClientChannelFactoryInterface *self, TpChannel *channel); } TpClientChannelFactoryInterface;
Interface for a channel factory
GTypeInterface |
the parent |
the function used to create channels | |
channel features that have to be prepared on newly created channels |
Since 0.13.2
TpChannel * tp_client_channel_factory_create_channel (TpClientChannelFactoryInterface *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.
|
a client channel factory |
|
a TpConnection |
|
the object path of the channel |
|
the immutable properties of the channel. [transfer none][element-type utf8 GObject.Value] |
|
used to indicate the error if NULL is returned
|
Returns : |
a new channel proxy, or NULL on invalid arguments
|
Since 0.13.2
GArray * tp_client_channel_factory_dup_channel_features (TpClientChannelFactoryInterface *self
,TpChannel *channel
);
Return a GArray containing the TpChannel features that
should be prepared on channel
.
|
a client channel factory |
|
a TpChannel |
Returns : |
a newly allocated GArray. [transfer full] |
Since 0.13.3