Medium connectionRemove

From TrillWiki

The medium_connectionRemove notification is called whenever a connection is removed from Trillian. This can happen when the medium requests that it be removed or when the user removes it via a right click.

Compatibility: 2.0 and higher

Contents 1 Syntax 2 Parameters 3 Return Value 4 Remarks

Syntax

callback(int window_id, char *icontrol, "medium_connectionRemove", connection_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 connectionRemove utilitizes the connection_entry_t structure.

struct connection_entry_t {  
 	unsigned int			struct_size; 
 
 	char				*medium; 
 
 	int				connection_id; 
 
 	char				*name; 
 	char				*status; 
 
 	/* 2.0 
 	 */ 
 	char				*section; 
 	struct menu_entry_t		*menu_entry; 
 };

medium

The medium associated with the connection.

connection_id

The connection_id associated with the connection.

name

The name associated with the connection.

Return Value

Must return 0.

Remarks

Do not call a connection remove when this notification is received otherwise you will generate an infinite loop.

See also: connectionRemove