since: 3.0.0

Declaration [src]

purple_account_set_status_attrs (
  PurpleAccount* account,
  const char* status_id,
  gboolean active,
  GHashTable* attrs

Description [src]

Activates or deactivates a status.

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

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.

Available since: 3.0.0

This method is renamed to purple_account_set_status() in language bindings



Type: 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.

Type: gboolean

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


Type: GHashTable

A hash table with keys of attribute names and values of attributes for the status. (For example, one pair might be a key of "message" with a value of "hello, talk to me!".)

The data is owned by the caller of the function.