Method

PurpleAccountset_status

Declaration [src]

void
purple_account_set_status (
  PurpleAccount* account,
  const char* status_id,
  gboolean active,
  ...
)

Description [src]

Activates or deactivates a status.

All changes to the statuses of an account go through this function or purple_account_set_status_attrs().

You can only deactivate an exclusive status by activating another exclusive status. So, if status_id is an exclusive status and active is FALSE, this function does nothing.

Variadic version of purple_account_set_status_attrs().

This method is not directly available to language bindings.
The implementation of this method is provided by purple_account_set_status_attrs() in language bindings

Parameters

status_id const char*
 

The ID of the status.

 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
active gboolean
 

Whether status_id is to be activated (TRUE) or deactivated (FALSE).

...
 

A NULL-terminated list of pairs of const char * attribute name followed by const char * attribute value for the status. (For example, one pair might be "message" followed by "hello, talk to me!".)