MailFolderCache

MailFolderCache — Stores information about open folders

Functions

Types and Values

Description

Functions

mail_folder_cache_new ()

MailFolderCache *
mail_folder_cache_new (void);

mail_folder_cache_new is deprecated and should not be used in newly-written code.


mail_folder_cache_ref_main_context ()

GMainContext *
mail_folder_cache_ref_main_context (MailFolderCache *cache);

mail_folder_cache_ref_main_context is deprecated and should not be used in newly-written code.

Returns the GMainContext on which event sources for cache are to be attached.

The returned GMainContext is referenced for thread-safety and should be unreferenced with g_main_context_unref() when finished with it.

Returns

a GMainContext


mail_folder_cache_note_store ()

void
mail_folder_cache_note_store (MailFolderCache *cache,
                              CamelStore *store,
                              GCancellable *cancellable,
                              GAsyncReadyCallback callback,
                              gpointer user_data);

mail_folder_cache_note_store is deprecated and should not be used in newly-written code.

Add a store whose folders should appear in the shell The folders are scanned from the store, and/or added at runtime via the folder_created event. The done function returns if we can free folder info.


mail_folder_cache_note_store_finish ()

gboolean
mail_folder_cache_note_store_finish (MailFolderCache *cache,
                                     GAsyncResult *result,
                                     CamelFolderInfo **out_info,
                                     GError **error);

mail_folder_cache_note_store_finish is deprecated and should not be used in newly-written code.


mail_folder_cache_note_folder ()

void
mail_folder_cache_note_folder (MailFolderCache *cache,
                               CamelFolder *folder);

mail_folder_cache_note_folder is deprecated and should not be used in newly-written code.

When a folder has been opened, notify it for watching. The folder must have already been created on the store (which has already been noted) before the folder can be opened


mail_folder_cache_has_folder_info ()

gboolean
mail_folder_cache_has_folder_info (MailFolderCache *cache,
                                   CamelStore *store,
                                   const gchar *folder_name);

mail_folder_cache_has_folder_info is deprecated and should not be used in newly-written code.

Returns whether cache has information about the folder described by store and folder_name . This does not necessarily mean it has the CamelFolder instance, but it at least has some meta-data about it.

You can use this function as a folder existence test.

Parameters

cache

a MailFolderCache

 

store

a CamelStore

 

folder_name

a folder name

 

Returns

TRUE if cache has folder info, FALSE otherwise


mail_folder_cache_ref_folder ()

CamelFolder *
mail_folder_cache_ref_folder (MailFolderCache *cache,
                              CamelStore *store,
                              const gchar *folder_name);

mail_folder_cache_ref_folder is deprecated and should not be used in newly-written code.

Returns the CamelFolder for store and folder_name if available, or else NULL if a CamelFolder instance is not yet cached. This function does not block.

The returned CamelFolder is referenced for thread-safety and must be unreferenced with g_object_unref() when finished with it.

Parameters

cache

a MailFolderCache

 

store

a CamelStore

 

folder_name

a folder name

 

Returns

a CamelFolder, or NULL


mail_folder_cache_get_folder_info_flags ()

gboolean
mail_folder_cache_get_folder_info_flags
                               (MailFolderCache *cache,
                                CamelStore *store,
                                const gchar *folder_name,
                                CamelFolderInfoFlags *flags);

mail_folder_cache_get_folder_info_flags is deprecated and should not be used in newly-written code.

Obtains CamelFolderInfoFlags for store and folder_name if available, and returns TRUE to indicate flags was set. If no folder information is available for store and folder_name , the function returns FALSE.

Parameters

cache

a MailFolderCache

 

store

a CamelStore

 

folder_name

a folder name

 

flags

return location for CamelFolderInfoFlags

 

Returns

whether flags was set


mail_folder_cache_get_local_folder_uris ()

void
mail_folder_cache_get_local_folder_uris
                               (MailFolderCache *cache,
                                GQueue *out_queue);

mail_folder_cache_get_local_folder_uris is deprecated and should not be used in newly-written code.


mail_folder_cache_get_remote_folder_uris ()

void
mail_folder_cache_get_remote_folder_uris
                               (MailFolderCache *cache,
                                GQueue *out_queue);

mail_folder_cache_get_remote_folder_uris is deprecated and should not be used in newly-written code.


mail_folder_cache_service_removed ()

void
mail_folder_cache_service_removed (MailFolderCache *cache,
                                   CamelService *service);

mail_folder_cache_service_removed is deprecated and should not be used in newly-written code.


mail_folder_cache_service_enabled ()

void
mail_folder_cache_service_enabled (MailFolderCache *cache,
                                   CamelService *service);

mail_folder_cache_service_enabled is deprecated and should not be used in newly-written code.


mail_folder_cache_service_disabled ()

void
mail_folder_cache_service_disabled (MailFolderCache *cache,
                                    CamelService *service);

mail_folder_cache_service_disabled is deprecated and should not be used in newly-written code.

Types and Values

struct MailFolderCache

struct MailFolderCache {
	GObject parent;
	MailFolderCachePrivate *priv;
};

MailFolderCache is deprecated and should not be used in newly-written code.

Contains only private data that should be read and manipulated using the functions below.