comparison libpurple/account.h @ 32827:4a34689eeb33 default tip

merged from im.pidgin.pidgin

32692:0f94ec89f0bc

	void *ui_data;              /**< The UI can put data here.              */
	PurpleAccountRegistrationCb registration_cb;
	void *registration_cb_user_data;

	gpointer priv;              /**< Pointer to opaque private data. */
};

#ifdef __cplusplus
extern "C" {
#endif

 * @param account The account to register.
 */
void purple_account_register(PurpleAccount *account);

/**
 * Unregisters an account (deleting it from the server).
 *
 * @param account The account to unregister.
 * @param cb Optional callback to be called when unregistration is complete
 * @param user_data user data to pass to the callback

 * Disconnects from an account.
 *
 * @param account The account to disconnect from.
 */
void purple_account_disconnect(PurpleAccount *account);

/**
 * Notifies the user that the account was added to a remote user's
 * buddy list.
 *

 */
void purple_account_set_ui_bool(PurpleAccount *account, const char *ui,
							  const char *name, gboolean value);

/**
 * Returns whether or not the account is connected.
 *
 * @param account The account.
 *
 * @return @c TRUE if connected, or @c FALSE otherwise.

32827:4a34689eeb33

	void *ui_data;              /**< The UI can put data here.              */
	PurpleAccountRegistrationCb registration_cb;
	void *registration_cb_user_data;

	PurpleConnectionErrorInfo *current_error;	/**< Errors */
};

#ifdef __cplusplus
extern "C" {
#endif

 * @param account The account to register.
 */
void purple_account_register(PurpleAccount *account);

/**
 * Registration of the account was completed.
 * Calls the registration call-back set with purple_account_set_register_callback().
 *
 * @param account The account being registered.
 * @param succeeded Was the account registration successful?
 */
void purple_account_register_completed(PurpleAccount *account, gboolean succeeded);

/**
 * Unregisters an account (deleting it from the server).
 *
 * @param account The account to unregister.
 * @param cb Optional callback to be called when unregistration is complete
 * @param user_data user data to pass to the callback

 * Disconnects from an account.
 *
 * @param account The account to disconnect from.
 */
void purple_account_disconnect(PurpleAccount *account);

/**
 * Indicates if the account is currently being disconnected.
 *
 * @param account The account
 *
 * @return TRUE if the account is being disconnected.
 */
gboolean purple_account_is_disconnecting(const PurpleAccount *account);

/**
 * Notifies the user that the account was added to a remote user's
 * buddy list.
 *

 */
void purple_account_set_ui_bool(PurpleAccount *account, const char *ui,
							  const char *name, gboolean value);

/**
 * Returns the UI data associated with this account.
 *
 * @param account The account.
 *
 * @return The UI data associated with this object.  This is a
 *         convenience field provided to the UIs--it is not
 *         used by the libuprple core.
 */
gpointer purple_account_get_ui_data(const PurpleAccount *account);

/**
 * Set the UI data associated with this account.
 *
 * @param account The account.
 * @param ui_data A pointer to associate with this object.
 */
void purple_account_set_ui_data(PurpleAccount *account, gpointer ui_data);

/**
 * Returns whether or not the account is connected.
 *
 * @param account The account.
 *
 * @return @c TRUE if connected, or @c FALSE otherwise.