ContactlistSubcontactUpdate

From TrillWiki

The contactlistSubcontactUpdate function will change the information for a particular subcontact.

Compatibility: 2.0 and higher

Contents 1 Syntax 2 Parameters 3 Return Value 4 Remarks

Syntax

plugin_send(MYGUID, "contactlistSubcontactUpdate", 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

ContactlistSubcontactUpdate 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 find the subcontact. This requires the real name (or uri), section and medium to be filled out.

subcontact

The information for the subcontact. Please look at the contactlistUpdate function to know which fields must be filled out and what each one means.

Return Value

Negative value on error, 0 on success.

Remarks

Be sure to set the menu and callback for all subcontacts to NULL when a plugin is stopped.