Method

PurpleAccountset_status_attrs

Declaration [src]

void
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

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