Method

PurpleAccountset_status_attrs

since: 3.0.0

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

Parameters

status_id

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.

active

Type: gboolean

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

attrs

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.