Account Signals

Signal List

Signal Details

account-created

void user_function(PurpleAccount *account, gpointer user_data);

Emitted when an account is created by calling purple_account_new.

Parameters:

account
The account.
user_data
User data set when the signal handler was connected.

account-destroying

void user_function(PurpleAccount *account, gpointer user_data);

Emitted when an account is about to be destroyed.

Parameters:

account
The account.
user_data
User data set when the signal handler was connected.

account-added

void user_function(PurpleAccount *account, gpointer user_data);

Emitted when an account is added.

Parameters:

account
The account that was added. See purple_accounts_add().
user_data
User data set when the signal handler was connected.

account-connecting

void user_function(PurpleAccount *account, gpointer user_data);

This is emitted when an account is in the process of connecting.

Parameters:

account
The account in the process of connecting.
user_data
User data set when the signal handler was connected.

account-removed

void user_function(PurpleAccount *account, gpointer user_data);

Emitted when an account is removed.

Parameters:

account
The account that was removed. See purple_accounts_remove().
user_data
User data set when the signal handler was connected.

account-disabled

void user_function(PurpleAccount *account, gpointer user_data);

Emitted when an account is disabled.

Parameters:

account
The account that was disabled.
user_data
User data set when the signal handler was connected.

account-enabled

void user_function(PurpleAccount *account, gpointer user_data);

Emitted when an account is enabled.

Parameters:

account
The account that was enabled.
user_data
User data set when the signal handler was connected.

account-setting-info

void user_function(PurpleAccount *account, const gchar *new_info, gpointer user_data);

Emitted when a user is about to send his new user info, or profile, to the server.

Parameters:

account
The account that the info will be set on.
new_info
The new information to set.
user_data
User data set when the signal handler was connected.

account-set-info

void user_function(PurpleAccount *account, const gchar *new_info, gpointer user_data);

Emitted when a user sent his new user info, or profile, to the server.

Parameters:

account
The account that the info was set on.
new_info
The new information set.
user_data
User data set when the signal handler was connected.

account-status-changed

void user_function(PurpleAccount *account,
                   PurpleStatus *old,
                   PurpleStatus *new,
                   gpointer user_data);

Emitted when the status of an account changes (after the change).

Parameters:

account
The account that changed status.
old
The status before change.
new
The status after change.
user_data
User data set when the signal handler was connected.

account-actions-changed

void user_function(PurpleAccount *account, gpointer user_data);

Emitted when the account actions are changed after initial connection.

Parameters:

account
The account whose actions changed.
user_data
User data set when the signal handler was connected.

account-alias-changed

void user_function(PurpleAccount *account, const gchar *old, gpointer user_data);

Emitted when the alias of an account changes (after the change).

Parameters:

account
The account for which the alias was changed.
old
The alias before change.
user_data
User data set when the signal handler was connected.

account-authorization-requested

int user_function(PurpleAccount *account,
                  const gchar *user,
                  const gchar *message,
                  gchar **response,
                  gpointer user_data);

Emitted when a user requests authorization.

Parameters:

account
The account.
user
The name of the user requesting authorization.
message
The authorization request message.
response
The message to send in the response.
user_data
User data set when the signal handler was connected.

Returns:

PURPLE_ACCOUNT_RESPONSE_IGNORE
To silently ignore the request
PURPLE_ACCOUNT_RESPONSE_DENY
To block the request (the sender might get informed)
PURPLE_ACCOUNT_RESPONSE_ACCEPT
If the request should be granted.
PURPLE_ACCOUNT_RESPONSE_PASS
The user will be prompted with the request.

account-authorization-denied

void user_function(PurpleAccount *account,
                   const gchar *user,
                   const gchar *message,
                   gpointer user_data);

Emitted when the authorization request for a buddy is denied.

Parameters:

account
The account.
user
The name of the user requesting authorization.
message
The message to tell the buddy who was denied.
user_data
User data set when the signal handler was connected.

account-authorization-granted

void user_function(PurpleAccount *account,
                   const gchar *user,
                   const gchar *message,
                   gpointer user_data);

Emitted when the authorization request for a buddy is granted.

Parameters:

account
The account.
user
The name of the user requesting authorization.
message
The message to tell the buddy who was granted authorization.
user_data
User data set when the signal handler was connected.

account-error-changed

void user_function(PurpleAccount *account,
                   const PurpleConnectionErrorInfo *old_error,
                   const PurpleConnectionErrorInfo *current_error,
                   gpointer user_data);

Emitted when account‘s error changes. You should not call purple_account_clear_current_error() while this signal is being emitted.

Parameters:

account
The account whose error has changed.
old_error
The account’s previous error, or NULL if it had no error. After this signal is emitted, old_error is not guaranteed to be a valid pointer.
new_error
The account’s new error, or NULL if it has no error. If not NULL, new_error will remain a valid until pointer just after the next time this signal is emitted for this account. See purple_account_get_current_error().
user_data
User data set when the signal handler was connected.

account-signed-on

void user_function(PurpleAccount *account, gpointer user_data);

Emitted when an account has signed on.

Parameters:

account
The account that has signed on.
user_data
User data set when the signal handler was connected.

account-signed-off

void user_function(PurpleAccount *account, gpointer user_data);

Emitted when an account has signed off.

Parameters:

account
The account that has signed off.
user_data
User data set when the signal handler was connected.

account-connection-error

void user_function(PurpleAccount *account,
                   PurpleConnectionError err,
                   const gchar *desc,
                   gpointer user_data)

Emitted when a connection error occurs, before "signed"-off.

Parameters:

account
The account on which the error has occurred.
err
The error that occurred.
desc
A description of the error, giving more information.
user_data
User data set when the signal handler was connected.