G_BEGIN_DECLS
+
+
+
+
/**
* modest_tny_account_new_from_account:
* @account_mgr: a valid account mgr instance
* @forget_pass_func: the forget-password function
*
* get a tnyaccount corresponding to the server_accounts (store or transport) for this account.
- * NOTE: this function does not set the camel session or the get/forget password functions
*
* Returns: a new TnyAccount or NULL in case of error.
*/
/**
+ * modest_tny_account_update_from_account:
+ * @tny_account: a valid tny_account
+ *
+ * update a tnyaccount corresponding to the server_accounts (store or transport) for this account.
+ *
+ * Returns: a TRUE or FALSE in case of error.
+ */
+gboolean
+modest_tny_account_update_from_account (TnyAccount *tny_account);
+
+
+/**
* modest_tny_account_new_for_local_folders:
* @account_mgr: a valid account mgr instance
* @session: a tny camel session
/**
* modest_tny_account_new_from_server_account_name:
* @account_mgr: a valid account mgr instance
+ * @session: a valid TnySessionCamel instance.
* @server_account_name: the name of a server account in the configuration system.
*
* Returns: a new TnyAccount or NULL in case of error.
*/
TnyAccount*
modest_tny_account_new_from_server_account_name (ModestAccountMgr *account_mgr,
- const gchar* server_account_name);
-
+ TnySessionCamel *session,
+ const gchar* server_account_name,
+ TnyGetPassFunc get_pass_func,
+ TnyForgetPassFunc forget_pass_func);
+
+#if 0
+/**
+ * modest_tny_account_new_from_server_account_name:
+ * @tny_account: a valid tny account
+ * @account_mgr: a valid account mgr instance
+ * @server_account_name: the name of a server account in the configuration system.
+ *
+ * update the given tny account; note that you cannot change the protocol type
+ *
+ * Returns: a new TnyAccount or NULL in case of error.
+ */
+gboolean modest_tny_account_update_from_server_account_name (TnyAccount *tny_account,
+ ModestAccountMgr *account_mgr,
+ const gchar *server_account_name);
+#endif
+
/**
* modest_tny_account_get_special_folder:
* @self: a TnyAccount
* such as (for example) server-side Sent/Junk mail for IMAP accounts
*
* Returns: the tny folder corresponding to this special folder, or NULL in case
- * of error, or if the special folder does not exist for this account
+ * of error, or if the special folder does not exist for this account.
+ * This must be unrefed with g_object_unref().
*/
TnyFolder* modest_tny_account_get_special_folder (TnyAccount *self,
TnyFolderType special_type);
* calling the callback (if not NULL) to notify that the name is changed.
* if the name was changed. The callback will not be called if the name was not changed.
*/
-void modest_tny_account_get_mmc_account_name (TnyStoreAccount* self, ModestTnyAccountGetMmcAccountNameCallback callback, gpointer user_data);
+void modest_tny_account_get_mmc_account_name (TnyStoreAccount* self,
+ ModestTnyAccountGetMmcAccountNameCallback callback,
+ gpointer user_data);
+
+
+/** modest_tny_account_is_virtual_local_folders:
+ * @self A TnyAccount.
+ *
+ * A convenience function to identify whether TnyAccount
+ * is the virtual local folders account, containing the folders from local_folders/
+ * and the outboxes from outboxes/<account-name>/.
+ **/
+gboolean modest_tny_account_is_virtual_local_folders (TnyAccount *self);
+
+/** modest_tny_account_is_memory_card_account:
+ * @self A TnyAccount.
+ *
+ * A convenience function to identify whether TnyAccount
+ * is the memory card account.
+ **/
+gboolean modest_tny_account_is_memory_card_account (TnyAccount *self);
+
G_END_DECLS