McdChannel

## McdChannel McdChannel — Channel class representing Telepathy channel class |

## Stability Level

Unstable, unless otherwise indicated

## Synopsis

    #include <mcd-channel.h>

                        McdChannel;
    enum                McdChannelStatus;
    struct              mcd_channel_request;
    McdChannel*         mcd_channel_new                     (TpChan *channel,
                                                             const gchar *channel_object_path,
                                                             const gchar *channel_type,
                                                             guint channel_handle,
                                                             TelepathyHandleType channel_handle_type,
                                                             gboolean outgoing,
                                                             guint requestor_serial,
                                                             const gchar *requestor_client_id);
    void                mcd_channel_set_status              (McdChannel *channel,
                                                             McdChannelStatus status);
    McdChannelStatus    mcd_channel_get_status              (McdChannel *channel);
    gboolean            mcd_channel_get_members_accepted    (McdChannel *channel);
    const gchar*        mcd_channel_get_channel_type        (McdChannel *channel);
    GQuark              mcd_channel_get_channel_type_quark  (McdChannel *channel);
    const gchar*        mcd_channel_get_object_path         (McdChannel *channel);
    guint               mcd_channel_get_handle              (McdChannel *channel);
    TelepathyHandleType mcd_channel_get_handle_type         (McdChannel *channel);
    gint                mcd_channel_get_flags               (McdChannel *channel);
    GPtrArray*          mcd_channel_get_members             (McdChannel *channel);
    const gchar*        mcd_channel_get_name                (McdChannel *channel);

## Description

FIXME

## Details

### McdChannel

    typedef struct {
        McdMission parent;
    } McdChannel;

### enum McdChannelStatus

    typedef enum
    {
        MCD_CHANNEL_PENDING,     /* Telepathy channel is not yet created */
        MCD_CHANNEL_DISPATCHING, /* Telepathy channel is created and waiting dispatch */
        MCD_CHANNEL_DISPATCHED,  /* Channel has been dispatched to handler */
        MCD_CHANNEL_FAILED,      /* Channel could not be dispached to handler, dying */

    } McdChannelStatus;

### struct mcd_channel_request

    struct mcd_channel_request {
        const gchar *account_name;
        const gchar *channel_type;
        guint channel_handle;
        const gchar *channel_handle_string;
        gint channel_handle_type;
        guint requestor_serial;
        const gchar *requestor_client_id;
    };

### mcd_channel_new ()

    McdChannel*         mcd_channel_new                     (TpChan *channel,
                                                             const gchar *channel_object_path,
                                                             const gchar *channel_type,
                                                             guint channel_handle,
                                                             TelepathyHandleType channel_handle_type,
                                                             gboolean outgoing,
                                                             guint requestor_serial,
                                                             const gchar *requestor_client_id);

`channel` : |
`channel_object_path` : |
`channel_type` : |
`channel_handle` : |
`channel_handle_type` : |
`outgoing` : |
`requestor_serial` : |
`requestor_client_id` : |
Returns : |

### mcd_channel_set_status ()

    void                mcd_channel_set_status              (McdChannel *channel,
                                                             McdChannelStatus status);

`channel` : |
`status` : |

### mcd_channel_get_status ()

    McdChannelStatus    mcd_channel_get_status              (McdChannel *channel);

`channel` : |
Returns : |

### mcd_channel_get_members_accepted ()

    gboolean            mcd_channel_get_members_accepted    (McdChannel *channel);

`channel` : |
Returns : |

### mcd_channel_get_channel_type ()

    const gchar*        mcd_channel_get_channel_type        (McdChannel *channel);

`channel` : |
Returns : |

### mcd_channel_get_channel_type_quark ()

    GQuark              mcd_channel_get_channel_type_quark  (McdChannel *channel);

`channel` : |
Returns : |

### mcd_channel_get_object_path ()

    const gchar*        mcd_channel_get_object_path         (McdChannel *channel);

`channel` : |
Returns : |

### mcd_channel_get_handle ()

    guint               mcd_channel_get_handle              (McdChannel *channel);

`channel` : |
Returns : |

### mcd_channel_get_handle_type ()

    TelepathyHandleType mcd_channel_get_handle_type         (McdChannel *channel);

`channel` : |
Returns : |

### mcd_channel_get_flags ()

    gint                mcd_channel_get_flags               (McdChannel *channel);

`channel` : |
Returns : |

### mcd_channel_get_members ()

    GPtrArray*          mcd_channel_get_members             (McdChannel *channel);

`channel` : |
Returns : |

### mcd_channel_get_name ()

    const gchar*        mcd_channel_get_name                (McdChannel *channel);

Get the Telepathy name of `channel` (calls InspectHandles on the channel handle).

`channel` : | the McdChannel.
Returns : | a const string holding the channel name.