![]() |
![]() |
![]() |
telepathy-glib Reference Manual | ![]() |
---|---|---|---|---|
Tube channelsTube channels — service-side interface for the Tube channel interface, StreamTube channel type and DBusTube channel type. |
#include <telepathy-glib/svc-channel.h> TpSvcChannelInterfaceTube; TpSvcChannelInterfaceTubeClass; void tp_svc_channel_interface_tube_emit_tube_channel_state_changed (gpointer instance, guint arg_State); TpSvcChannelTypeStreamTube; TpSvcChannelTypeStreamTubeClass; void (*tp_svc_channel_type_stream_tube_offer_impl) (TpSvcChannelTypeStreamTube *self, guint in_address_type, const GValue *in_address, guint in_access_control, GHashTable *in_parameters, DBusGMethodInvocation *context); void tp_svc_channel_type_stream_tube_implement_offer (TpSvcChannelTypeStreamTubeClass *klass, tp_svc_channel_type_stream_tube_offer_impl impl); void tp_svc_channel_type_stream_tube_return_from_offer (DBusGMethodInvocation *context); void (*tp_svc_channel_type_stream_tube_accept_impl) (TpSvcChannelTypeStreamTube *self, guint in_address_type, guint in_access_control, const GValue *in_access_control_param, DBusGMethodInvocation *context); void tp_svc_channel_type_stream_tube_implement_accept (TpSvcChannelTypeStreamTubeClass *klass, tp_svc_channel_type_stream_tube_accept_impl impl); void tp_svc_channel_type_stream_tube_return_from_accept (DBusGMethodInvocation *context, const GValue *out_address); void tp_svc_channel_type_stream_tube_emit_new_remote_connection (gpointer instance, guint arg_Handle, const GValue *arg_Connection_Param, guint arg_Connection_ID); void tp_svc_channel_type_stream_tube_emit_new_local_connection (gpointer instance, guint arg_Connection_ID); void tp_svc_channel_type_stream_tube_emit_connection_closed (gpointer instance, guint arg_Connection_ID, const gchar *arg_Error, const gchar *arg_Message); TpSvcChannelTypeDBusTube; TpSvcChannelTypeDBusTubeClass; void (*tp_svc_channel_type_dbus_tube_offer_impl) (TpSvcChannelTypeDBusTube *self, GHashTable *in_parameters, guint in_access_control, DBusGMethodInvocation *context); void tp_svc_channel_type_dbus_tube_implement_offer (TpSvcChannelTypeDBusTubeClass *klass, tp_svc_channel_type_dbus_tube_offer_impl impl); void tp_svc_channel_type_dbus_tube_return_from_offer (DBusGMethodInvocation *context, const gchar *out_address); void (*tp_svc_channel_type_dbus_tube_accept_impl) (TpSvcChannelTypeDBusTube *self, guint in_access_control, DBusGMethodInvocation *context); void tp_svc_channel_type_dbus_tube_implement_accept (TpSvcChannelTypeDBusTubeClass *klass, tp_svc_channel_type_dbus_tube_accept_impl impl); void tp_svc_channel_type_dbus_tube_return_from_accept (DBusGMethodInvocation *context, const gchar *out_address); void tp_svc_channel_type_dbus_tube_emit_dbus_names_changed (gpointer instance, GHashTable *arg_Added, const GArray *arg_Removed);
A "tube" is a mechanism for arbitrary data transfer. This section documents the auto-generated C wrappers for the Tube channel interface, StreamTube channel type and DBusTube channel type.
typedef struct _TpSvcChannelInterfaceTube TpSvcChannelInterfaceTube;
Dummy typedef representing any implementation of this interface.
typedef struct _TpSvcChannelInterfaceTubeClass TpSvcChannelInterfaceTubeClass;
The class of TpSvcChannelInterfaceTube.
This interface has no D-Bus methods, so an
implementation can typically pass NULL
to
G_IMPLEMENT_INTERFACE()
as the interface
initialization function.
void tp_svc_channel_interface_tube_emit_tube_channel_state_changed (gpointer instance, guint arg_State);
Type-safe wrapper around g_signal_emit to emit the TubeChannelStateChanged signal on interface org.freedesktop.Telepathy.Channel.Interface.Tube.
instance : |
The object implementing this interface |
arg_State : |
guint (FIXME, generate documentation) |
typedef struct _TpSvcChannelTypeStreamTube TpSvcChannelTypeStreamTube;
Dummy typedef representing any implementation of this interface.
typedef struct _TpSvcChannelTypeStreamTubeClass TpSvcChannelTypeStreamTubeClass;
The class of TpSvcChannelTypeStreamTube.
In a full implementation of this interface (i.e. all
methods implemented), the interface initialization
function used in G_IMPLEMENT_INTERFACE()
would
typically look like this:
static void implement_channel_type_stream_tube (gpointer klass, gpointer unused G_GNUC_UNUSED) { #define IMPLEMENT(x) tp_svc_channel_type_stream_tube_implement_##x (\ klass, my_object_##x) IMPLEMENT (offer); IMPLEMENT (accept); #undef IMPLEMENT }
void (*tp_svc_channel_type_stream_tube_offer_impl) (TpSvcChannelTypeStreamTube *self, guint in_address_type, const GValue *in_address, guint in_access_control, GHashTable *in_parameters, DBusGMethodInvocation *context);
The signature of an implementation of the D-Bus method Offer on interface org.freedesktop.Telepathy.Channel.Type.StreamTube.
self : |
The object implementing this interface |
in_address_type : |
guint (FIXME, generate documentation) |
in_address : |
const GValue * (FIXME, generate documentation) |
in_access_control : |
guint (FIXME, generate documentation) |
in_parameters : |
GHashTable * (FIXME, generate documentation) |
context : |
Used to return values or throw an error |
void tp_svc_channel_type_stream_tube_implement_offer (TpSvcChannelTypeStreamTubeClass *klass, tp_svc_channel_type_stream_tube_offer_impl impl);
Register an implementation for the Offer method in the vtable of an implementation of this interface. To be called from the interface init function.
klass : |
A class whose instances implement this interface |
impl : |
A callback used to implement the Offer D-Bus method |
void tp_svc_channel_type_stream_tube_return_from_offer (DBusGMethodInvocation *context);
Return successfully by calling dbus_g_method_return()
.
This inline function exists only to provide type-safety.
context : |
The D-Bus method invocation context |
void (*tp_svc_channel_type_stream_tube_accept_impl) (TpSvcChannelTypeStreamTube *self, guint in_address_type, guint in_access_control, const GValue *in_access_control_param, DBusGMethodInvocation *context);
The signature of an implementation of the D-Bus method Accept on interface org.freedesktop.Telepathy.Channel.Type.StreamTube.
self : |
The object implementing this interface |
in_address_type : |
guint (FIXME, generate documentation) |
in_access_control : |
guint (FIXME, generate documentation) |
in_access_control_param : |
const GValue * (FIXME, generate documentation) |
context : |
Used to return values or throw an error |
void tp_svc_channel_type_stream_tube_implement_accept (TpSvcChannelTypeStreamTubeClass *klass, tp_svc_channel_type_stream_tube_accept_impl impl);
Register an implementation for the Accept method in the vtable of an implementation of this interface. To be called from the interface init function.
klass : |
A class whose instances implement this interface |
impl : |
A callback used to implement the Accept D-Bus method |
void tp_svc_channel_type_stream_tube_return_from_accept (DBusGMethodInvocation *context, const GValue *out_address);
Return successfully by calling dbus_g_method_return()
.
This inline function exists only to provide type-safety.
context : |
The D-Bus method invocation context |
out_address : |
const GValue * (FIXME, generate documentation) |
void tp_svc_channel_type_stream_tube_emit_new_remote_connection (gpointer instance, guint arg_Handle, const GValue *arg_Connection_Param, guint arg_Connection_ID);
Type-safe wrapper around g_signal_emit to emit the NewRemoteConnection signal on interface org.freedesktop.Telepathy.Channel.Type.StreamTube.
instance : |
The object implementing this interface |
arg_Handle : |
guint (FIXME, generate documentation) |
arg_Connection_Param : |
const GValue * (FIXME, generate documentation) |
arg_Connection_ID : |
guint (FIXME, generate documentation) |
void tp_svc_channel_type_stream_tube_emit_new_local_connection (gpointer instance, guint arg_Connection_ID);
Type-safe wrapper around g_signal_emit to emit the NewLocalConnection signal on interface org.freedesktop.Telepathy.Channel.Type.StreamTube.
instance : |
The object implementing this interface |
arg_Connection_ID : |
guint (FIXME, generate documentation) |
void tp_svc_channel_type_stream_tube_emit_connection_closed (gpointer instance, guint arg_Connection_ID, const gchar *arg_Error, const gchar *arg_Message);
Type-safe wrapper around g_signal_emit to emit the ConnectionClosed signal on interface org.freedesktop.Telepathy.Channel.Type.StreamTube.
instance : |
The object implementing this interface |
arg_Connection_ID : |
guint (FIXME, generate documentation) |
arg_Error : |
const gchar * (FIXME, generate documentation) |
arg_Message : |
const gchar * (FIXME, generate documentation) |
typedef struct _TpSvcChannelTypeDBusTube TpSvcChannelTypeDBusTube;
Dummy typedef representing any implementation of this interface.
typedef struct _TpSvcChannelTypeDBusTubeClass TpSvcChannelTypeDBusTubeClass;
The class of TpSvcChannelTypeDBusTube.
In a full implementation of this interface (i.e. all
methods implemented), the interface initialization
function used in G_IMPLEMENT_INTERFACE()
would
typically look like this:
static void implement_channel_type_dbus_tube (gpointer klass, gpointer unused G_GNUC_UNUSED) { #define IMPLEMENT(x) tp_svc_channel_type_dbus_tube_implement_##x (\ klass, my_object_##x) IMPLEMENT (offer); IMPLEMENT (accept); #undef IMPLEMENT }
void (*tp_svc_channel_type_dbus_tube_offer_impl) (TpSvcChannelTypeDBusTube *self, GHashTable *in_parameters, guint in_access_control, DBusGMethodInvocation *context);
The signature of an implementation of the D-Bus method Offer on interface org.freedesktop.Telepathy.Channel.Type.DBusTube.
self : |
The object implementing this interface |
in_parameters : |
GHashTable * (FIXME, generate documentation) |
in_access_control : |
guint (FIXME, generate documentation) |
context : |
Used to return values or throw an error |
void tp_svc_channel_type_dbus_tube_implement_offer (TpSvcChannelTypeDBusTubeClass *klass, tp_svc_channel_type_dbus_tube_offer_impl impl);
Register an implementation for the Offer method in the vtable of an implementation of this interface. To be called from the interface init function.
klass : |
A class whose instances implement this interface |
impl : |
A callback used to implement the Offer D-Bus method |
void tp_svc_channel_type_dbus_tube_return_from_offer (DBusGMethodInvocation *context, const gchar *out_address);
Return successfully by calling dbus_g_method_return()
.
This inline function exists only to provide type-safety.
context : |
The D-Bus method invocation context |
out_address : |
const gchar * (FIXME, generate documentation) |
void (*tp_svc_channel_type_dbus_tube_accept_impl) (TpSvcChannelTypeDBusTube *self, guint in_access_control, DBusGMethodInvocation *context);
The signature of an implementation of the D-Bus method Accept on interface org.freedesktop.Telepathy.Channel.Type.DBusTube.
self : |
The object implementing this interface |
in_access_control : |
guint (FIXME, generate documentation) |
context : |
Used to return values or throw an error |
void tp_svc_channel_type_dbus_tube_implement_accept (TpSvcChannelTypeDBusTubeClass *klass, tp_svc_channel_type_dbus_tube_accept_impl impl);
Register an implementation for the Accept method in the vtable of an implementation of this interface. To be called from the interface init function.
klass : |
A class whose instances implement this interface |
impl : |
A callback used to implement the Accept D-Bus method |
void tp_svc_channel_type_dbus_tube_return_from_accept (DBusGMethodInvocation *context, const gchar *out_address);
Return successfully by calling dbus_g_method_return()
.
This inline function exists only to provide type-safety.
context : |
The D-Bus method invocation context |
out_address : |
const gchar * (FIXME, generate documentation) |
void tp_svc_channel_type_dbus_tube_emit_dbus_names_changed (gpointer instance, GHashTable *arg_Added, const GArray *arg_Removed);
Type-safe wrapper around g_signal_emit to emit the DBusNamesChanged signal on interface org.freedesktop.Telepathy.Channel.Type.DBusTube.
instance : |
The object implementing this interface |
arg_Added : |
GHashTable * (FIXME, generate documentation) |
arg_Removed : |
const GArray * (FIXME, generate documentation) |