Filetransfer status

From TrillWiki

Jump to: navigation, search

The filetransfer_status notification is sent when the user initiates a change of status. This usually happens when the user clicks the cancel button and cancels a file transfer while it is going.

Compatibility: 2.0 and higher

Contents

Syntax

callback(int window_id, char *icontrol, "filetransfer_status", filetransfer_status_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 status utilitizes the filetransfer_status_t structure.

struct filetransfer_status_t {  
 	unsigned int			struct_size; 
 
 	char				*medium; 
 
 	int				connection_id; 
 	int				filetransfer_id; 
 
 	char				*type;
 	char				*description; 
 
 	int				bytes; 
 };



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.
type
The type of status change. Valid types for this currently are "cancel" and "close" where "close" is not available before Trillian 4.0.


Return Value

Must return 0.

Remarks

None.


See also: filetransferInit

Personal tools