MailFolderCache: Evolution Mail Engine Reference Manual

## MailFolderCache MailFolderCache — Stores information about open folders |

## Functions

MailFolderCache * | mail_folder_cache_new ()
GMainContext * | mail_folder_cache_ref_main_context ()
void | mail_folder_cache_note_store ()
gboolean | mail_folder_cache_note_store_finish ()
void | mail_folder_cache_note_folder ()
gboolean | mail_folder_cache_has_folder_info ()
CamelFolder * | mail_folder_cache_ref_folder ()
gboolean | mail_folder_cache_get_folder_info_flags ()
void | mail_folder_cache_get_local_folder_uris ()
void | mail_folder_cache_get_remote_folder_uris ()
void | mail_folder_cache_service_removed ()
void | mail_folder_cache_service_enabled ()
void | mail_folder_cache_service_disabled ()

## Types and Values

struct | MailFolderCache

## 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.