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 a status_id is an exclusive status and a active is c FALSE, this function does nothing.

Available since:3.0.0


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 a status_id is to be activated (TRUE) or deactivated (FALSE).

attrs GHashTable

A hash table of const char * attribute names followed by gpointer attribute values for the status. (For example, one pair might be message” followed by hello, talk to me!”.)

 The data is owned by the caller of the function.