#include <glib-object.h>
#include <glib.h>
#include "connection.h"
#include "log.h"
#include "proxy.h"
#include "prpl.h"
#include "status.h"
Include dependency graph for account.h:
This graph shows which files directly or indirectly include this file:
Go to the source code of this file.
Data Structures | |
struct | _PurpleAccount |
struct | _PurpleAccountUiOps |
Typedefs | |
typedef _PurpleAccount | PurpleAccount |
typedef void(*) | PurpleAccountRequestAuthorizationCb (void *) |
typedef _PurpleAccountUiOps | PurpleAccountUiOps |
typedef gboolean(*) | PurpleFilterAccountFunc (PurpleAccount *account) |
Enumerations | |
enum | PurpleAccountRequestType { PURPLE_ACCOUNT_REQUEST_AUTHORIZATION = 0 } |
Account request types. More... | |
Functions | |
Account API | |
void | purple_account_add_buddies (PurpleAccount *account, GList *buddies) |
Adds a list of buddies to the server-side buddy list. | |
void | purple_account_add_buddy (PurpleAccount *account, PurpleBuddy *buddy) |
Adds a buddy to the server-side buddy list for the specified account. | |
void | purple_account_change_password (PurpleAccount *account, const char *orig_pw, const char *new_pw) |
Changes the password on the specified account. | |
void | purple_account_clear_settings (PurpleAccount *account) |
Clears all protocol-specific settings on an account. | |
void | purple_account_connect (PurpleAccount *account) |
Connects to an account. | |
void | purple_account_destroy (PurpleAccount *account) |
Destroys an account. | |
void | purple_account_destroy_log (PurpleAccount *account) |
Frees the system log of an account. | |
void | purple_account_disconnect (PurpleAccount *account) |
Disconnects from an account. | |
PurpleStatus * | purple_account_get_active_status (const PurpleAccount *account) |
Returns the active status for this account. | |
const char * | purple_account_get_alias (const PurpleAccount *account) |
Returns the account's alias. | |
gboolean | purple_account_get_bool (const PurpleAccount *account, const char *name, gboolean default_value) |
Returns a protocol-specific boolean setting for an account. | |
const char * | purple_account_get_buddy_icon_path (const PurpleAccount *account) |
Gets the account's buddy icon path. | |
gboolean | purple_account_get_check_mail (const PurpleAccount *account) |
Returns whether or not this account should check for mail. | |
PurpleConnection * | purple_account_get_connection (const PurpleAccount *account) |
Returns the account's connection. | |
gboolean | purple_account_get_enabled (const PurpleAccount *account, const char *ui) |
Returns whether or not this account is enabled for the specified UI. | |
int | purple_account_get_int (const PurpleAccount *account, const char *name, int default_value) |
Returns a protocol-specific integer setting for an account. | |
PurpleLog * | purple_account_get_log (PurpleAccount *account, gboolean create) |
Returns the system log for an account. | |
const char * | purple_account_get_password (const PurpleAccount *account) |
Returns the account's password. | |
PurplePresence * | purple_account_get_presence (const PurpleAccount *account) |
Returns the account's presence. | |
const char * | purple_account_get_protocol_id (const PurpleAccount *account) |
Returns the account's protocol ID. | |
const char * | purple_account_get_protocol_name (const PurpleAccount *account) |
Returns the account's protocol name. | |
PurpleProxyInfo * | purple_account_get_proxy_info (const PurpleAccount *account) |
Returns the account's proxy information. | |
gboolean | purple_account_get_remember_password (const PurpleAccount *account) |
Returns whether or not this account should save its password. | |
PurpleStatus * | purple_account_get_status (const PurpleAccount *account, const char *status_id) |
Returns the account status with the specified ID. | |
PurpleStatusType * | purple_account_get_status_type (const PurpleAccount *account, const char *id) |
Returns the account status type with the specified ID. | |
PurpleStatusType * | purple_account_get_status_type_with_primitive (const PurpleAccount *account, PurpleStatusPrimitive primitive) |
Returns the account status type with the specified primitive. | |
const GList * | purple_account_get_status_types (const PurpleAccount *account) |
Returns the account's status types. | |
const char * | purple_account_get_string (const PurpleAccount *account, const char *name, const char *default_value) |
Returns a protocol-specific string setting for an account. | |
gboolean | purple_account_get_ui_bool (const PurpleAccount *account, const char *ui, const char *name, gboolean default_value) |
Returns a UI-specific boolean setting for an account. | |
int | purple_account_get_ui_int (const PurpleAccount *account, const char *ui, const char *name, int default_value) |
Returns a UI-specific integer setting for an account. | |
const char * | purple_account_get_ui_string (const PurpleAccount *account, const char *ui, const char *name, const char *default_value) |
Returns a UI-specific string setting for an account. | |
const char * | purple_account_get_user_info (const PurpleAccount *account) |
Returns the account's user information. | |
const char * | purple_account_get_username (const PurpleAccount *account) |
Returns the account's username. | |
gboolean | purple_account_is_connected (const PurpleAccount *account) |
Returns whether or not the account is connected. | |
gboolean | purple_account_is_connecting (const PurpleAccount *account) |
Returns whether or not the account is connecting. | |
gboolean | purple_account_is_disconnected (const PurpleAccount *account) |
Returns whether or not the account is disconnected. | |
gboolean | purple_account_is_status_active (const PurpleAccount *account, const char *status_id) |
Returns whether or not an account status is active. | |
PurpleAccount * | purple_account_new (const char *username, const char *protocol_id) |
Creates a new account. | |
void | purple_account_notify_added (PurpleAccount *account, const char *remote_user, const char *id, const char *alias, const char *message) |
Notifies the user that the account was added to a remote user's buddy list. | |
void | purple_account_register (PurpleAccount *account) |
Registers an account. | |
void | purple_account_remove_buddies (PurpleAccount *account, GList *buddies, GList *groups) |
Removes a list of buddies from the server-side buddy list. | |
void | purple_account_remove_buddy (PurpleAccount *account, PurpleBuddy *buddy, PurpleGroup *group) |
Removes a buddy from the server-side buddy list. | |
void | purple_account_remove_group (PurpleAccount *account, PurpleGroup *group) |
Removes a group from the server-side buddy list. | |
void | purple_account_request_add (PurpleAccount *account, const char *remote_user, const char *id, const char *alias, const char *message) |
Notifies the user that the account was addded to a remote user's buddy list and asks ther user if they want to add the remote user to their buddy list. | |
void * | purple_account_request_authorization (PurpleAccount *account, const char *remote_user, const char *id, const char *alias, const char *message, gboolean on_list, GCallback auth_cb, GCallback deny_cb, void *user_data) |
Notifies the user that a remote user has wants to add the local user to his or her buddy list and requires authorization to d oso. | |
void | purple_account_request_change_password (PurpleAccount *account) |
Requests information from the user to change the account's password. | |
void | purple_account_request_change_user_info (PurpleAccount *account) |
Requests information from the user to change the account's user information. | |
void | purple_account_request_close (void *ui_handle) |
Close the account request for the given ui handle. | |
void | purple_account_request_close_with_account (PurpleAccount *account) |
Close account requests registered for the given PurpleAccount. | |
void | purple_account_request_password (PurpleAccount *account, GCallback ok_cb, GCallback cancel_cb, void *user_data) |
Requests a password from the user for the account. | |
void | purple_account_set_alias (PurpleAccount *account, const char *alias) |
Sets the account's alias. | |
void | purple_account_set_bool (PurpleAccount *account, const char *name, gboolean value) |
Sets a protocol-specific boolean setting for an account. | |
void | purple_account_set_buddy_icon_path (PurpleAccount *account, const char *path) |
Sets the account's buddy icon path. | |
void | purple_account_set_check_mail (PurpleAccount *account, gboolean value) |
Sets whether or not this account should check for mail. | |
void | purple_account_set_connection (PurpleAccount *account, PurpleConnection *gc) |
Sets the account's connection. | |
void | purple_account_set_enabled (PurpleAccount *account, const char *ui, gboolean value) |
Sets whether or not this account is enabled for the specified UI. | |
void | purple_account_set_int (PurpleAccount *account, const char *name, int value) |
Sets a protocol-specific integer setting for an account. | |
void | purple_account_set_password (PurpleAccount *account, const char *password) |
Sets the account's password. | |
void | purple_account_set_protocol_id (PurpleAccount *account, const char *protocol_id) |
Sets the account's protocol ID. | |
void | purple_account_set_proxy_info (PurpleAccount *account, PurpleProxyInfo *info) |
Sets the account's proxy information. | |
void | purple_account_set_remember_password (PurpleAccount *account, gboolean value) |
Sets whether or not this account should save its password. | |
void | purple_account_set_status (PurpleAccount *account, const char *status_id, gboolean active,...) |
Activates or deactivates a status. | |
void | purple_account_set_status_list (PurpleAccount *account, const char *status_id, gboolean active, GList *attrs) |
Activates or deactivates a status. | |
void | purple_account_set_status_types (PurpleAccount *account, GList *status_types) |
Sets the account's status types. | |
void | purple_account_set_string (PurpleAccount *account, const char *name, const char *value) |
Sets a protocol-specific string setting for an account. | |
void | purple_account_set_ui_bool (PurpleAccount *account, const char *ui, const char *name, gboolean value) |
Sets a UI-specific boolean setting for an account. | |
void | purple_account_set_ui_int (PurpleAccount *account, const char *ui, const char *name, int value) |
Sets a UI-specific integer setting for an account. | |
void | purple_account_set_ui_string (PurpleAccount *account, const char *ui, const char *name, const char *value) |
Sets a UI-specific string setting for an account. | |
void | purple_account_set_user_info (PurpleAccount *account, const char *user_info) |
Sets the account's user information. | |
void | purple_account_set_username (PurpleAccount *account, const char *username) |
Sets the account's username. | |
gboolean | purple_account_supports_offline_message (PurpleAccount *account, PurpleBuddy *buddy) |
Whether the account supports sending offline messages to buddy. | |
Accounts API | |
void | purple_accounts_add (PurpleAccount *account) |
Adds an account to the list of accounts. | |
void | purple_accounts_delete (PurpleAccount *account) |
Deletes an account. | |
PurpleAccount * | purple_accounts_find (const char *name, const char *protocol) |
Finds an account with the specified name and protocol id. | |
GList * | purple_accounts_get_all (void) |
Returns a list of all accounts. | |
GList * | purple_accounts_get_all_active (void) |
Returns a list of all enabled accounts. | |
void | purple_accounts_remove (PurpleAccount *account) |
Removes an account from the list of accounts. | |
void | purple_accounts_reorder (PurpleAccount *account, gint new_index) |
Reorders an account. | |
void | purple_accounts_restore_current_statuses (void) |
This is called by the core after all subsystems and what not have been initialized. | |
Accounts Subsystem | |
void * | purple_accounts_get_handle (void) |
Returns the accounts subsystem handle. | |
void | purple_accounts_init (void) |
Initializes the accounts subsystem. | |
void | purple_accounts_uninit (void) |
Uninitializes the accounts subsystem. | |
UI Registration Functions | |
PurpleAccountUiOps * | purple_accounts_get_ui_ops (void) |
Returns the UI operations structure used for accounts. | |
void | purple_accounts_set_ui_ops (PurpleAccountUiOps *ops) |
Sets the UI operations structure to be used for accounts. |
purple
Purple is the legal property of its developers, whose names are too numerous to list here. Please refer to the COPYRIGHT file distributed with this source distribution.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Definition in file account.h.
void purple_account_add_buddies | ( | PurpleAccount * | account, | |
GList * | buddies | |||
) |
Adds a list of buddies to the server-side buddy list.
account | The account. | |
buddies | The list of PurpleBlistNodes representing the buddies to add. |
void purple_account_add_buddy | ( | PurpleAccount * | account, | |
PurpleBuddy * | buddy | |||
) |
Adds a buddy to the server-side buddy list for the specified account.
account | The account. | |
buddy | The buddy to add. |
void purple_account_change_password | ( | PurpleAccount * | account, | |
const char * | orig_pw, | |||
const char * | new_pw | |||
) |
Changes the password on the specified account.
account | The account. | |
orig_pw | The old password. | |
new_pw | The new password. |
void purple_account_clear_settings | ( | PurpleAccount * | account | ) |
Clears all protocol-specific settings on an account.
account | The account. |
void purple_account_connect | ( | PurpleAccount * | account | ) |
Connects to an account.
account | The account to connect to. |
void purple_account_destroy | ( | PurpleAccount * | account | ) |
Destroys an account.
account | The account to destroy. |
void purple_account_destroy_log | ( | PurpleAccount * | account | ) |
Frees the system log of an account.
account | The account. |
void purple_account_disconnect | ( | PurpleAccount * | account | ) |
Disconnects from an account.
account | The account to disconnect from. |
PurpleStatus* purple_account_get_active_status | ( | const PurpleAccount * | account | ) |
Returns the active status for this account.
This looks through the PurplePresence associated with this account and returns the PurpleStatus that has its active flag set to "TRUE." There can be only one active PurpleStatus in a PurplePresence.
account | The account. |
const char* purple_account_get_alias | ( | const PurpleAccount * | account | ) |
Returns the account's alias.
account | The account. |
gboolean purple_account_get_bool | ( | const PurpleAccount * | account, | |
const char * | name, | |||
gboolean | default_value | |||
) |
Returns a protocol-specific boolean setting for an account.
account | The account. | |
name | The name of the setting. | |
default_value | The default value. |
const char* purple_account_get_buddy_icon_path | ( | const PurpleAccount * | account | ) |
Gets the account's buddy icon path.
account | The account. |
gboolean purple_account_get_check_mail | ( | const PurpleAccount * | account | ) |
Returns whether or not this account should check for mail.
account | The account. |
TRUE
if it should check for mail. PurpleConnection* purple_account_get_connection | ( | const PurpleAccount * | account | ) |
Returns the account's connection.
account | The account. |
gboolean purple_account_get_enabled | ( | const PurpleAccount * | account, | |
const char * | ui | |||
) |
Returns whether or not this account is enabled for the specified UI.
account | The account. | |
ui | The UI. |
TRUE
if it enabled on this UI. int purple_account_get_int | ( | const PurpleAccount * | account, | |
const char * | name, | |||
int | default_value | |||
) |
Returns a protocol-specific integer setting for an account.
account | The account. | |
name | The name of the setting. | |
default_value | The default value. |
PurpleLog* purple_account_get_log | ( | PurpleAccount * | account, | |
gboolean | create | |||
) |
Returns the system log for an account.
account | The account. | |
create | Should it be created if it doesn't exist? |
FALSE
for create. Passing TRUE
could result in an existing log being reopened, if the log has already been closed, which not all loggers deal with appropriately. const char* purple_account_get_password | ( | const PurpleAccount * | account | ) |
Returns the account's password.
account | The account. |
PurplePresence* purple_account_get_presence | ( | const PurpleAccount * | account | ) |
Returns the account's presence.
account | The account. |
const char* purple_account_get_protocol_id | ( | const PurpleAccount * | account | ) |
Returns the account's protocol ID.
account | The account. |
const char* purple_account_get_protocol_name | ( | const PurpleAccount * | account | ) |
Returns the account's protocol name.
account | The account. |
PurpleProxyInfo* purple_account_get_proxy_info | ( | const PurpleAccount * | account | ) |
Returns the account's proxy information.
account | The account. |
gboolean purple_account_get_remember_password | ( | const PurpleAccount * | account | ) |
Returns whether or not this account should save its password.
account | The account. |
TRUE
if it should remember the password. PurpleStatus* purple_account_get_status | ( | const PurpleAccount * | account, | |
const char * | status_id | |||
) |
Returns the account status with the specified ID.
Note that this works differently than purple_buddy_get_status() in that it will only return NULL if the status was not registered.
account | The account. | |
status_id | The status ID. |
PurpleStatusType* purple_account_get_status_type | ( | const PurpleAccount * | account, | |
const char * | id | |||
) |
Returns the account status type with the specified ID.
account | The account. | |
id | The ID of the status type to find. |
PurpleStatusType* purple_account_get_status_type_with_primitive | ( | const PurpleAccount * | account, | |
PurpleStatusPrimitive | primitive | |||
) |
Returns the account status type with the specified primitive.
Note: It is possible for an account to have more than one PurpleStatusType with the same primitive. In this case, the first PurpleStatusType is returned.
account | The account. | |
primitive | The type of the status type to find. |
const GList* purple_account_get_status_types | ( | const PurpleAccount * | account | ) |
Returns the account's status types.
account | The account. |
const char* purple_account_get_string | ( | const PurpleAccount * | account, | |
const char * | name, | |||
const char * | default_value | |||
) |
Returns a protocol-specific string setting for an account.
account | The account. | |
name | The name of the setting. | |
default_value | The default value. |
gboolean purple_account_get_ui_bool | ( | const PurpleAccount * | account, | |
const char * | ui, | |||
const char * | name, | |||
gboolean | default_value | |||
) |
Returns a UI-specific boolean setting for an account.
account | The account. | |
ui | The UI name. | |
name | The name of the setting. | |
default_value | The default value. |
int purple_account_get_ui_int | ( | const PurpleAccount * | account, | |
const char * | ui, | |||
const char * | name, | |||
int | default_value | |||
) |
Returns a UI-specific integer setting for an account.
account | The account. | |
ui | The UI name. | |
name | The name of the setting. | |
default_value | The default value. |
const char* purple_account_get_ui_string | ( | const PurpleAccount * | account, | |
const char * | ui, | |||
const char * | name, | |||
const char * | default_value | |||
) |
Returns a UI-specific string setting for an account.
account | The account. | |
ui | The UI name. | |
name | The name of the setting. | |
default_value | The default value. |
const char* purple_account_get_user_info | ( | const PurpleAccount * | account | ) |
Returns the account's user information.
account | The account. |
const char* purple_account_get_username | ( | const PurpleAccount * | account | ) |
Returns the account's username.
account | The account. |
gboolean purple_account_is_connected | ( | const PurpleAccount * | account | ) |
Returns whether or not the account is connected.
account | The account. |
TRUE
if connected, or FALSE
otherwise. gboolean purple_account_is_connecting | ( | const PurpleAccount * | account | ) |
Returns whether or not the account is connecting.
account | The account. |
TRUE
if connecting, or FALSE
otherwise. gboolean purple_account_is_disconnected | ( | const PurpleAccount * | account | ) |
Returns whether or not the account is disconnected.
account | The account. |
TRUE
if disconnected, or FALSE
otherwise. gboolean purple_account_is_status_active | ( | const PurpleAccount * | account, | |
const char * | status_id | |||
) |
Returns whether or not an account status is active.
account | The account. | |
status_id | The status ID. |
PurpleAccount* purple_account_new | ( | const char * | username, | |
const char * | protocol_id | |||
) |
Creates a new account.
username | The username. | |
protocol_id | The protocol ID. |
void purple_account_notify_added | ( | PurpleAccount * | account, | |
const char * | remote_user, | |||
const char * | id, | |||
const char * | alias, | |||
const char * | message | |||
) |
Notifies the user that the account was added to a remote user's buddy list.
This will present a dialog informing the user that he was added to the remote user's buddy list.
account | The account that was added. | |
remote_user | The name of the user that added this account. | |
id | The optional ID of the local account. Rarely used. | |
alias | The optional alias of the user. | |
message | The optional message sent from the user adding you. |
void purple_account_register | ( | PurpleAccount * | account | ) |
Registers an account.
account | The account to register. |
void purple_account_remove_buddies | ( | PurpleAccount * | account, | |
GList * | buddies, | |||
GList * | groups | |||
) |
Removes a list of buddies from the server-side buddy list.
account | The account. | |
buddies | The list of buddies to remove. | |
groups | The list of groups to remove buddies from. Each node of this list should match the corresponding node of buddies. |
void purple_account_remove_buddy | ( | PurpleAccount * | account, | |
PurpleBuddy * | buddy, | |||
PurpleGroup * | group | |||
) |
Removes a buddy from the server-side buddy list.
account | The account. | |
buddy | The buddy to remove. | |
group | The group to remove the buddy from. |
void purple_account_remove_group | ( | PurpleAccount * | account, | |
PurpleGroup * | group | |||
) |
Removes a group from the server-side buddy list.
account | The account. | |
group | The group to remove. |
void purple_account_request_add | ( | PurpleAccount * | account, | |
const char * | remote_user, | |||
const char * | id, | |||
const char * | alias, | |||
const char * | message | |||
) |
Notifies the user that the account was addded to a remote user's buddy list and asks ther user if they want to add the remote user to their buddy list.
This will present a dialog informing the local user that the remote user added them to the remote user's buddy list and will ask if they want to add the remote user to the buddy list.
account | The account that was added. | |
remote_user | The name of the user that added this account. | |
id | The optional ID of the local account. Rarely used. | |
alias | The optional alias of the user. | |
message | The optional message sent from the user adding you. |
void* purple_account_request_authorization | ( | PurpleAccount * | account, | |
const char * | remote_user, | |||
const char * | id, | |||
const char * | alias, | |||
const char * | message, | |||
gboolean | on_list, | |||
GCallback | auth_cb, | |||
GCallback | deny_cb, | |||
void * | user_data | |||
) |
Notifies the user that a remote user has wants to add the local user to his or her buddy list and requires authorization to d oso.
This will present a dialog informing the user of this and ask if the user authorizes or denies the remote user from adding him.
account | The account that was added | |
remote_user | The name of the user that added this account. | |
id | The optional ID of the local account. Rarely used. | |
alias | The optional alias of the remote user. | |
message | The optional message sent from the uer requesting you | |
on_list | Is the remote user already on the buddy list? | |
auth_cb | The callback called when the local user accepts | |
deny_cb | The callback called when the local user rejects | |
user_data | Data to be passed back to the above callbacks |
void purple_account_request_change_password | ( | PurpleAccount * | account | ) |
Requests information from the user to change the account's password.
account | The account to change the password on. |
void purple_account_request_change_user_info | ( | PurpleAccount * | account | ) |
Requests information from the user to change the account's user information.
account | The account to change the user information on. |
void purple_account_request_close | ( | void * | ui_handle | ) |
Close the account request for the given ui handle.
ui_handle | The ui specific handle for which requests should be closed |
void purple_account_request_close_with_account | ( | PurpleAccount * | account | ) |
Close account requests registered for the given PurpleAccount.
account | The account for which requests should be closed |
void purple_account_request_password | ( | PurpleAccount * | account, | |
GCallback | ok_cb, | |||
GCallback | cancel_cb, | |||
void * | user_data | |||
) |
Requests a password from the user for the account.
Does not set the account password on success; do that in ok_cb if desired.
account | The account to request the password for. | |
ok_cb | The callback for the OK button. | |
cancel_cb | The callback for the cancel button. | |
user_data | User data to be passed into callbacks. |
void purple_account_set_alias | ( | PurpleAccount * | account, | |
const char * | alias | |||
) |
Sets the account's alias.
account | The account. | |
alias | The alias. |
void purple_account_set_bool | ( | PurpleAccount * | account, | |
const char * | name, | |||
gboolean | value | |||
) |
Sets a protocol-specific boolean setting for an account.
account | The account. | |
name | The name of the setting. | |
value | The setting's value. |
void purple_account_set_buddy_icon_path | ( | PurpleAccount * | account, | |
const char * | path | |||
) |
Sets the account's buddy icon path.
account | The account. | |
path | The buddy icon non-cached path. |
void purple_account_set_check_mail | ( | PurpleAccount * | account, | |
gboolean | value | |||
) |
Sets whether or not this account should check for mail.
account | The account. | |
value | TRUE if it should check for mail. |
void purple_account_set_connection | ( | PurpleAccount * | account, | |
PurpleConnection * | gc | |||
) |
Sets the account's connection.
account | The account. | |
gc | The connection. |
void purple_account_set_enabled | ( | PurpleAccount * | account, | |
const char * | ui, | |||
gboolean | value | |||
) |
Sets whether or not this account is enabled for the specified UI.
account | The account. | |
ui | The UI. | |
value | TRUE if it is enabled. |
void purple_account_set_int | ( | PurpleAccount * | account, | |
const char * | name, | |||
int | value | |||
) |
Sets a protocol-specific integer setting for an account.
account | The account. | |
name | The name of the setting. | |
value | The setting's value. |
void purple_account_set_password | ( | PurpleAccount * | account, | |
const char * | password | |||
) |
Sets the account's password.
account | The account. | |
password | The password. |
void purple_account_set_protocol_id | ( | PurpleAccount * | account, | |
const char * | protocol_id | |||
) |
Sets the account's protocol ID.
account | The account. | |
protocol_id | The protocol ID. |
void purple_account_set_proxy_info | ( | PurpleAccount * | account, | |
PurpleProxyInfo * | info | |||
) |
Sets the account's proxy information.
account | The account. | |
info | The proxy information. |
void purple_account_set_remember_password | ( | PurpleAccount * | account, | |
gboolean | value | |||
) |
Sets whether or not this account should save its password.
account | The account. | |
value | TRUE if it should remember the password. |
void purple_account_set_status | ( | PurpleAccount * | account, | |
const char * | status_id, | |||
gboolean | active, | |||
... | ||||
) |
Activates or deactivates a status.
All changes to the statuses of an account go through this function or purple_account_set_status_list.
Only independent statuses can be deactivated with this. To deactivate an exclusive status, activate a different (and exclusive?) status.
account | The account. | |
status_id | The ID of the status. | |
active | The active state. | |
... | Pairs of attributes for the new status passed in as a NULL-terminated list of id/value pairs. |
void purple_account_set_status_list | ( | PurpleAccount * | account, | |
const char * | status_id, | |||
gboolean | active, | |||
GList * | attrs | |||
) |
Activates or deactivates a status.
All changes to the statuses of an account go through this function or purple_account_set_status.
Only independent statuses can be deactivated with this. To deactivate an exclusive status, activate a different (and exclusive?) status.
account | The account. | |
status_id | The ID of the status. | |
active | The active state. | |
attrs | A list of attributes in key/value pairs |
void purple_account_set_status_types | ( | PurpleAccount * | account, | |
GList * | status_types | |||
) |
Sets the account's status types.
account | The account. | |
status_types | The list of status types. |
void purple_account_set_string | ( | PurpleAccount * | account, | |
const char * | name, | |||
const char * | value | |||
) |
Sets a protocol-specific string setting for an account.
account | The account. | |
name | The name of the setting. | |
value | The setting's value. |
void purple_account_set_ui_bool | ( | PurpleAccount * | account, | |
const char * | ui, | |||
const char * | name, | |||
gboolean | value | |||
) |
Sets a UI-specific boolean setting for an account.
account | The account. | |
ui | The UI name. | |
name | The name of the setting. | |
value | The setting's value. |
void purple_account_set_ui_int | ( | PurpleAccount * | account, | |
const char * | ui, | |||
const char * | name, | |||
int | value | |||
) |
Sets a UI-specific integer setting for an account.
account | The account. | |
ui | The UI name. | |
name | The name of the setting. | |
value | The setting's value. |
void purple_account_set_ui_string | ( | PurpleAccount * | account, | |
const char * | ui, | |||
const char * | name, | |||
const char * | value | |||
) |
Sets a UI-specific string setting for an account.
account | The account. | |
ui | The UI name. | |
name | The name of the setting. | |
value | The setting's value. |
void purple_account_set_user_info | ( | PurpleAccount * | account, | |
const char * | user_info | |||
) |
Sets the account's user information.
account | The account. | |
user_info | The user information. |
void purple_account_set_username | ( | PurpleAccount * | account, | |
const char * | username | |||
) |
Sets the account's username.
account | The account. | |
username | The username. |
gboolean purple_account_supports_offline_message | ( | PurpleAccount * | account, | |
PurpleBuddy * | buddy | |||
) |
Whether the account supports sending offline messages to buddy.
account | The account | |
buddy | The buddy |
void purple_accounts_add | ( | PurpleAccount * | account | ) |
Adds an account to the list of accounts.
account | The account. |
void purple_accounts_delete | ( | PurpleAccount * | account | ) |
Deletes an account.
This will remove any buddies from the buddy list that belong to this account, buddy pounces that belong to this account, and will also destroy account.
account | The account. |
PurpleAccount* purple_accounts_find | ( | const char * | name, | |
const char * | protocol | |||
) |
Finds an account with the specified name and protocol id.
name | The account username. | |
protocol | The account protocol ID. |
FALSE
otherwise. GList* purple_accounts_get_all | ( | void | ) |
Returns a list of all accounts.
GList* purple_accounts_get_all_active | ( | void | ) |
Returns a list of all enabled accounts.
void* purple_accounts_get_handle | ( | void | ) |
Returns the accounts subsystem handle.
PurpleAccountUiOps* purple_accounts_get_ui_ops | ( | void | ) |
Returns the UI operations structure used for accounts.
void purple_accounts_remove | ( | PurpleAccount * | account | ) |
Removes an account from the list of accounts.
account | The account. |
void purple_accounts_reorder | ( | PurpleAccount * | account, | |
gint | new_index | |||
) |
Reorders an account.
account | The account to reorder. | |
new_index | The new index for the account. |
void purple_accounts_restore_current_statuses | ( | void | ) |
This is called by the core after all subsystems and what not have been initialized.
It sets all enabled accounts to their startup status by signing them on, setting them away, etc.
You probably shouldn't call this unless you really know what you're doing.
void purple_accounts_set_ui_ops | ( | PurpleAccountUiOps * | ops | ) |
Sets the UI operations structure to be used for accounts.
ops | The UI operations structure. |