Medium accountConnect

From TrillWiki

The medium_accountConnect notification is sent when the user wishes to connect to a particular account.

Compatibility: 2.0 and higher

Contents 1 Syntax 2 Parameters 3 Return Value 4 Remarks

Syntax

callback(int window_id, char *icontrol, "medium_accountConnect", account_entry_t *data, void *userData);

Note that all Trillian functions and notifications begin with a lower-case letter, despite the Wiki requirement that all pages start with a capital letter.

Parameters

Medium accountConnect utilitizes the account_entry_t structure.

struct account_entry_t
{
    unsigned int                struct_size;

    char                        *account;
    char                        *medium;
    char                        *status;
    char                        *section;

    int                         connected;
    long                        last_connected;

    HICON                       icon;
    HWND                        window;

    /* 3.0
     */
    ttkCallback                 callback;
    void                        *data;
};

account

The account to connect.

medium

The medium to connect the account on.

window

The parent window to create the dialog from (if required).

Return Value

Must return 0.

Remarks

If the account is already connected to, the medium can either ignore or let the user know that this is the case. If a connection already exists for this account but is disconnect, this should connect that connection.