## TpStreamTubeConnection

TpStreamTubeConnection — a connection on a Stream Tube

## Synopsis

    #include <telepathy-glib/stream-tube-connection.h>

                        TpStreamTubeConnection;
                        TpStreamTubeConnectionClass;
    TpStreamTubeChannel * tp_stream_tube_connection_get_channel
                                                            (TpStreamTubeConnection *self);
    TpContact *         tp_stream_tube_connection_get_contact
                                                            (TpStreamTubeConnection *self);
    GSocketConnection * tp_stream_tube_connection_get_socket_connection
                                                            (TpStreamTubeConnection *self);

## Object Hierarchy

      GObject
       +----TpStreamTubeConnection

## Properties

      "channel"                  TpStreamTubeChannel*  : Read / Write / Construct Only
      "contact"                  TpContact*            : Read / Write / Construct Only
      "socket-connection"        GSocketConnection*    : Read / Write / Construct Only

## Signals

      "closed"                                         : Run Last

## Description

Object used to represent a connection on a TpStreamTubeChannel.

## Details

### TpStreamTubeConnection

    typedef struct _TpStreamTubeConnection TpStreamTubeConnection;

Data structure representing a connection on a TpStreamTubeChannel.

Since 0.13.2

### TpStreamTubeConnectionClass

    typedef struct _TpStreamTubeConnectionClass TpStreamTubeConnectionClass;

The class of a TpStreamTubeConnection.

Since 0.13.2

### tp_stream_tube_connection_get_channel ()

    TpStreamTubeChannel * tp_stream_tube_connection_get_channel
                                                            (TpStreamTubeConnection *self);

Return the "channel" property

`self` : | a TpStreamTubeConnection
Returns : | the value of "channel". [transfer none]

Since 0.13.2

### tp_stream_tube_connection_get_contact ()

    TpContact *         tp_stream_tube_connection_get_contact
                                                            (TpStreamTubeConnection *self);

Return the "contact" property

`self` : | a TpStreamTubeConnection
Returns : | the value of "contact". [transfer none]

Since 0.13.2

### tp_stream_tube_connection_get_socket_connection ()

    GSocketConnection * tp_stream_tube_connection_get_socket_connection
                                                            (TpStreamTubeConnection *self);

Return the "socket-connection" property

`self` : | a TpStreamTubeConnection
Returns : | the value of "socket-connection". [transfer none]

Since 0.13.2

## Property Details

### The `"channel"` property

      "channel"                  TpStreamTubeChannel*  : Read / Write / Construct Only

The TpStreamTubeChannel channel associated with this connection

This property can't be `NULL`.

Since 0.13.2

### The `"contact"` property

      "contact"                  TpContact*            : Read / Write / Construct Only

The TpContact with who we are exchanging data through this tube, or `NULL` if we can't safely identify the contact.

If not `NULL`, the TpContact objects is guaranteed to have all of the features previously passed to `tp_simple_client_factory_add_contact_features()` prepared.

Since 0.13.2

### The `"socket-connection"` property

      "socket-connection"        GSocketConnection*    : Read / Write / Construct Only

The GSocketConnection used to transfer data through this connection. Read-only except during construction.

This property can't be `NULL`.

Since 0.13.2

## Signal Details

### The `"closed"` signal

    void                user_function                      (TpStreamTubeConnection *self,
                                                            GError                 *error,
                                                            gpointer                user_data)      : Run Last

The ::closed signal is emitted when the connection manager reports that a tube connection has been closed.

`self` : | the TpStreamTubeConnection
`error` : | a GError representing the error reported by the connection manager. [transfer none]
`user_data` : | user data set when the signal handler was connected.

Since 0.13.2