ContactlistSubcontactRemove

From TrillWiki

The contactlistSubcontactRemove function removes a subcontact added to a particular contact.

Compatibility: 2.0 and higher

Contents 1 Syntax 2 Parameters 3 Return Value 4 Remarks

Syntax

plugin_send(MYGUID, "contactlistSubcontactRemove", struct contactlist_subcontact_t *);

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

ContactlistSubcontactRemove utilitizes the contactlist_subcontact_t structure.

struct contactlist_subcontact_t { 
 	unsigned int			struct_size; 
 
 	struct contactlist_entry_t	*parent; 
 	struct contactlist_entry_t	*subcontact; 
 };

parent

The main contact in which to remove the subcontact from. This requires the real name (or uri), section and medium to be filled out.

subcontact

The real name for the particular subcontact must be supplied to remove the subcontact.

Return Value

Negative value on error, 0 on success.

Remarks

None.