Filetransfer request

From TrillWiki

The filetransfer_request notification is sent if the ask_confirmation variable is set on the initiation. This allows a medium to do a last minute check to see if file transfering is allowed at this time for this particular contact. An example of this is that some mediums do not allow file transfering to themselves within the contact list and they can check for this prior to showing the window, etc.

Compatibility: 2.0 and higher

Contents 1 Syntax 2 Parameters 3 Return Value 4 Remarks

Syntax

callback(int window_id, char *icontrol, "filetransfer_request", filetransfer_request_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

Filetransfer request utilitizes the filetransfer_request_t structure.

struct filetransfer_request_t
{
    unsigned int                struct_size;

    char                        *medium;

    int                         connection_id;
    int                         filetransfer_id;

    int                         ask_description;

    /* 3.0
     */
    int                         window_id;
    char                        *remote_screen_name;
};

medium

The medium for the file transfer.

connection_id

The connection id associated with the file transfer.

filetransfer_id

The file transfer id associated with the transfer.

ask_description

[out] Set the ask_description variable for the filetransferInit when you receive this message to the correct value.

Return Value

Return 1 if the file transfer is allowed, 0 if it is not allowed.

Remarks

None.

See also: filetransferInit