ESourceRegistry: Evolution-Data-Server Reference Manual

## ESourceRegistry ESourceRegistry — A central repository for data sources |

## Functions

ESourceRegistry * | e_source_registry_new_sync ()
void | e_source_registry_new ()
ESourceRegistry * | e_source_registry_new_finish ()
EOAuth2Services * | e_source_registry_get_oauth2_services ()
gboolean | e_source_registry_commit_source_sync ()
void | e_source_registry_commit_source ()
gboolean | e_source_registry_commit_source_finish ()
gboolean | e_source_registry_create_sources_sync ()
void | e_source_registry_create_sources ()
gboolean | e_source_registry_create_sources_finish ()
gboolean | e_source_registry_refresh_backend_sync ()
void | e_source_registry_refresh_backend ()
gboolean | e_source_registry_refresh_backend_finish ()
ESource * | e_source_registry_ref_source ()
GList * | e_source_registry_list_sources ()
GList * | e_source_registry_list_enabled ()
ESource * | e_source_registry_find_extension ()
gboolean | e_source_registry_check_enabled ()
GNode * | e_source_registry_build_display_tree ()
void | e_source_registry_free_display_tree ()
gchar * | e_source_registry_dup_unique_display_name ()
void | e_source_registry_debug_dump ()
ESource * | e_source_registry_ref_builtin_address_book ()
ESource * | e_source_registry_ref_builtin_calendar ()
ESource * | e_source_registry_ref_builtin_mail_account ()
ESource * | e_source_registry_ref_builtin_memo_list ()
ESource * | e_source_registry_ref_builtin_proxy ()
ESource * | e_source_registry_ref_builtin_task_list ()
ESource * | e_source_registry_ref_default_address_book ()
void | e_source_registry_set_default_address_book ()
ESource * | e_source_registry_ref_default_calendar ()
void | e_source_registry_set_default_calendar ()
ESource * | e_source_registry_ref_default_mail_account ()
void | e_source_registry_set_default_mail_account ()
ESource * | e_source_registry_ref_default_mail_identity ()
void | e_source_registry_set_default_mail_identity ()
ESource * | e_source_registry_ref_default_memo_list ()
void | e_source_registry_set_default_memo_list ()
ESource * | e_source_registry_ref_default_task_list ()
void | e_source_registry_set_default_task_list ()
ESource * | e_source_registry_ref_default_for_extension_name ()
void | e_source_registry_set_default_for_extension_name ()

## Types and Values

struct | ESourceRegistry

## Object Hierarchy

        GObject
        ╰── ESourceRegistry

## Implemented Interfaces

ESourceRegistry implements GInitable and GAsyncInitable.

## Includes

    #include <libedataserver/libedataserver.h>

## Description

The ESourceRegistry is a global singleton store for all ESource instances. It uses file monitors to react to key file creation and deletion events, either constructing an ESource instance from the newly created key file, or removing from the logical ESource hierarchy the instance corresponding to the deleted key file.

The ESourceRegistry can be queried for individual ESource instances by their unique identifier string or key file path, for collections of ESource instances having a particular extension, or for all available ESource instances.

The ESourceRegistry API also provides a front-end for the "org.gnome.Evolution.DefaultSources" GSettings schema which tracks which ESource instances are designated to be the user's default address book, calendar, memo list and task list for desktop integration.

Note: The ESourceRegistry uses thread default main context from the time of its creation to deliver D-Bus signals, finish operations and so on, thus it requires a running main loop for its proper functionality.

## Functions

### e_source_registry_new_sync ()

    ESourceRegistry *
    e_source_registry_new_sync (GCancellable *cancellable,
                                GError **error);

Creates a new ESourceRegistry front-end for the registry D-Bus service. If an error occurs in connecting to the D-Bus service, the function sets `error` and returns `NULL`.

Since 3.12 a singleton will be returned. No strong reference is kept internally, so it is the caller's responsibility to keep one.

#### Parameters

cancellable | optional GCancellable object, or `NULL` |
error | return location for a GError, or `NULL` |

#### Returns

a new ESourceRegistry, or `NULL` on error

Since: 3.6

### e_source_registry_new ()

    void
    e_source_registry_new (GCancellable *cancellable,
                           GAsyncReadyCallback callback,
                           gpointer user_data);

Asynchronously creates a new ESourceRegistry front-end for the registry D-Bus service.

When the operation is finished, `callback` will be called. You can then call `e_source_registry_new_finish()` to get the result of the operation.

Since 3.12 a singleton will be returned. No strong reference is kept internally, so it is the caller's responsibility to keep one.

#### Parameters

cancellable | optional GCancellable object, or `NULL` |
callback | a GAsyncReadyCallback to call when the request is satisfied |
user_data | data to pass to the callback function |

Since: 3.6

### e_source_registry_new_finish ()

    ESourceRegistry *
    e_source_registry_new_finish (GAsyncResult *result,
                                  GError **error);

Finishes the operation started with `e_source_registry_new_finish()`. If an error occurs in connecting to the D-Bus service, the function sets `error` and returns `NULL`.

#### Parameters

result | a GAsyncResult |
error | return location for a GError, or `NULL` |

#### Returns

a new ESourceRegistry, or `NULL` on error

Since: 3.6

### e_source_registry_get_oauth2_services ()

    EOAuth2Services *
    e_source_registry_get_oauth2_services (ESourceRegistry *registry);

#### Parameters

registry | an ESourceRegistry |

#### Returns

an instance of EOAuth2Services, owned by `registry` .

[transfer none]

Since: 3.28

### e_source_registry_commit_source_sync ()

    gboolean
    e_source_registry_commit_source_sync (ESourceRegistry *registry,
                                          ESource *source,
                                          GCancellable *cancellable,
                                          GError **error);

This is a convenience function intended for use with graphical ESource editors. Call this function when the user is finished making changes to `source` .

If `source` has a GDBusObject, its contents are submitted to the D-Bus service through `e_source_write_sync()`.

If `source` does NOT have a GDBusObject (implying it's a scratch ESource), its contents are submitted to the D-Bus service through either `e_source_remote_create_sync()` if `source` is to be a collection member, or `e_source_registry_create_sources_sync()` if `source` to be an independent data source.

If an error occurs, the function will set `error` and return `FALSE`.

#### Parameters

registry | an ESourceRegistry |
source | an ESource with changes to commit |
cancellable | optional GCancellable object, or `NULL` |
error | return location for GError, or `NULL` |

#### Returns

`TRUE` on success, `FALSE` on failure

Since: 3.6

### e_source_registry_commit_source ()

    void
    e_source_registry_commit_source (ESourceRegistry *registry,
                                     ESource *source,
                                     GCancellable *cancellable,
                                     GAsyncReadyCallback callback,
                                     gpointer user_data);

See `e_source_registry_commit_source_sync()` for details.

When the operation is finished, `callback` will be called. You can then call `e_source_registry_commit_source_finish()` to get the result of the operation.

#### Parameters

registry | an ESourceRegistry |
source | an ESource with changes to commit |
cancellable | optional GCancellable object, or `NULL` |
callback | a GAsyncReadyCallback to call when the request is satisfied |
user_data | data to pass to the callback function |

Since: 3.6

### e_source_registry_commit_source_finish ()

    gboolean
    e_source_registry_commit_source_finish
                                   (ESourceRegistry *registry,
                                    GAsyncResult *result,
                                    GError **error);

Finishes the operation started with `e_source_registry_commit_source()`.

If an error occurred, the function will set `error` and return `FALSE`.

#### Parameters

registry | an ESourceRegistry |
result | a GAsyncResult |
error | return location for a GError, or `NULL` |

#### Returns

`TRUE` on success, `FALSE` on failure

Since: 3.6

### e_source_registry_create_sources_sync ()

    gboolean
    e_source_registry_create_sources_sync (ESourceRegistry *registry,
                                           GList *list_of_sources,
                                           GCancellable *cancellable,
                                           GError **error);

Requests the D-Bus service create new key files for each ESource in `list_of_sources` . Each list element must be a scratch ESource with no GDBusObject.

If an error occurs, the function will set `error` and return `FALSE`.

#### Parameters

registry | an ESourceRegistry |
list_of_sources | a list of ESource instances with no GDBusObject. | [element-type ESource]
cancellable | optional GCancellable object, or `NULL` |
error | return location for a GError, or `NULL` |

#### Returns

`TRUE` on success, `FALSE` on failure

Since: 3.6

### e_source_registry_create_sources ()

    void
    e_source_registry_create_sources (ESourceRegistry *registry,
                                      GList *list_of_sources,
                                      GCancellable *cancellable,
                                      GAsyncReadyCallback callback,
                                      gpointer user_data);

Asynchronously requests the D-Bus service create new key files for each ESource in `list_of_sources` . Each list element must be a scratch ESource with no GDBusObject.

When the operation is finished, `callback` will be called. You can then call `e_source_registry_create_sources_finish()` to get the result of the operation.

#### Parameters

registry | an ESourceRegistry |
list_of_sources | a list of ESource instances with no GDBusObject. | [element-type ESource]
cancellable | optional GCancellable object, or `NULL` |
callback | a GAsyncReadyCallback to call when the request is satisfied |
user_data | data to pass to the callback function |

Since: 3.6

### e_source_registry_create_sources_finish ()

    gboolean
    e_source_registry_create_sources_finish
                                   (ESourceRegistry *registry,
                                    GAsyncResult *result,
                                    GError **error);

Finishes the operation started with `e_source_registry_create_sources()`.

If an error occurred, the function will set `error` and return `FALSE`.

#### Parameters

registry | an ESourceRegistry |
result | a GAsyncResult |
error | return location for a GError, or `NULL` |

#### Returns

`TRUE` on success, `FALSE` on failure

Since: 3.6

### e_source_registry_refresh_backend_sync ()

    gboolean
    e_source_registry_refresh_backend_sync
                                   (ESourceRegistry *registry,
                                    const gchar *source_uid,
                                    GCancellable *cancellable,
                                    GError **error);

Requests the D-Bus service to refresh collection backend for an ESource with UID `source_uid` . The result means that the refresh had been scheduled not whether the refresh itself succeeded. The refresh is not initiated when the collection backend is offline.

If an error occurs, the function will set `error` and return `FALSE`.

#### Parameters

registry | an ESourceRegistry |
source_uid | UID of a collection ESource whose backend to refresh |
cancellable | optional GCancellable object, or `NULL` |
error | return location for a GError, or `NULL` |

#### Returns

Whether succeeded

Since: 3.30

### e_source_registry_refresh_backend ()

    void
    e_source_registry_refresh_backend (ESourceRegistry *registry,
                                       const gchar *source_uid,
                                       GCancellable *cancellable,
                                       GAsyncReadyCallback callback,
                                       gpointer user_data);

Asynchronously requests the D-Bus service to refresh collection backend for an ESource with UID `source_uid` . The result means that the refresh had been scheduled not whether the refresh itself succeeded. The refresh is not initiated when the collection backend is offline.

When the operation is finished, `callback` will be called. You can then call `e_source_registry_refresh_backend_finish()` to get the result of the operation.

#### Parameters

registry | an ESourceRegistry |
source_uid | UID of a collection ESource whose backend to refresh |
cancellable | optional GCancellable object, or `NULL` |
callback | a GAsyncReadyCallback to call when the request is satisfied |
user_data | data to pass to the callback function |

Since: 3.30

### e_source_registry_refresh_backend_finish ()

    gboolean
    e_source_registry_refresh_backend_finish
                                   (ESourceRegistry *registry,
                                    GAsyncResult *result,
                                    GError **error);

Finishes the operation started with `e_source_registry_refresh_backend()`.

If an error occurred, the function will set `error` and return `FALSE`.

#### Parameters

registry | an ESourceRegistry |
result | a GAsyncResult |
error | return location for a GError, or `NULL` |

#### Returns

Whether succeeded

Since: 3.30

### e_source_registry_ref_source ()

    ESource *
    e_source_registry_ref_source (ESourceRegistry *registry,
                                  const gchar *uid);

Looks up an ESource in `registry` by its unique identifier string.

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

#### Parameters

registry | an ESourceRegistry |
uid | a unique identifier string |

#### Returns

an ESource, or `NULL` if no match was found.

[transfer full][nullable]

Since: 3.6

### e_source_registry_list_sources ()

    GList *
    e_source_registry_list_sources (ESourceRegistry *registry,
                                    const gchar *extension_name);

Returns a list of registered sources, sorted by display name. If `extension_name` is given, restrict the list to sources having that extension name.

The sources returned in the list are referenced for thread-safety. They must each be unreferenced with `g_object_unref()` when finished with them. Free the returned list itself with `g_list_free()`.

An easy way to free the list properly in one step is as follows:

    1
    g_list_free_full (list, g_object_unref);

#### Parameters

registry | an ESourceRegistry |
extension_name | an extension name, or `NULL`. | [nullable]

#### Returns

a sorted list of sources.

[element-type ESource][transfer full]

Since: 3.6

### e_source_registry_list_enabled ()

    GList *
    e_source_registry_list_enabled (ESourceRegistry *registry,
                                    const gchar *extension_name);

Similar to `e_source_registry_list_sources()`, but returns only enabled sources according to `e_source_registry_check_enabled()`.

The sources returned in the list are referenced for thread-safety. They must each be unreferenced with `g_object_unref()` when finished with them. Free the returned list itself with `g_list_free()`.

An easy way to free the list properly in one step is as follows:

    1
    g_list_free_full (list, g_object_unref);

#### Parameters

registry | an ESourceRegistry |
extension_name | an extension name, or `NULL`. | [nullable]

#### Returns

a sorted list of sources.

[element-type ESource][transfer full]

Since: 3.10

### e_source_registry_find_extension ()

    ESource *
    e_source_registry_find_extension (ESourceRegistry *registry,
                                      ESource *source,
                                      const gchar *extension_name);

Examines `source` and its ancestors and returns the "deepest" ESource having an ESourceExtension with the given `extension_name` . If neither `source` nor any of its ancestors have such an extension, the function returns `NULL`.

This function is useful in cases when an ESourceExtension is meant to apply to both the ESource it belongs to and the ESource's descendants.

A common example is the ESourceCollection extension, where descendants of an ESource having an ESourceCollection extension are implied to be members of that collection. In that example, this function can be used to test whether `source` is a member of a collection.

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

Note the function returns the ESource containing the ESourceExtension instead of the ESourceExtension itself because extension instances are not to be referenced directly (see `e_source_get_extension()`).

#### Parameters

registry | an ESourceRegistry |
source | an ESource |
extension_name | the extension name to find |

#### Returns

an ESource, or `NULL` if no match was found.

[transfer full][nullable]

Since: 3.6

### e_source_registry_check_enabled ()

    gboolean
    e_source_registry_check_enabled (ESourceRegistry *registry,
                                     ESource *source);

Determines whether `source` is "effectively" enabled by examining its own “enabled” property as well as those of its ancestors in the ESource hierarchy. If all examined “enabled” properties are `TRUE`, then the function returns `TRUE`. If any are `FALSE`, then the function returns `FALSE`.

Use this function instead of `e_source_get_enabled()` to determine things like whether to display an ESource in a user interface or whether to act on the data set described by the ESource.

#### Parameters

registry | an ESourceRegistry |
source | an ESource |

#### Returns

whether `source` is "effectively" enabled

Since: 3.8

### e_source_registry_build_display_tree ()

    GNode *
    e_source_registry_build_display_tree (ESourceRegistry *registry,
                                          const gchar *extension_name);

Returns a single GNode tree of registered sources that can be used to populate a GtkTreeModel. (The root GNode is just an empty placeholder.)

Similar to `e_source_registry_list_sources()`, an `extension_name` can be given to restrict the tree to sources having that extension name. Parents of matched sources are included in the tree regardless of whether they have an extension named `extension_name` .

Disabled leaf nodes are automatically excluded from the GNode tree.

The sources returned in the tree are referenced for thread-safety. They must each be unreferenced with `g_object_unref()` when finished with them. Free the returned tree itself with `g_node_destroy()`. For convenience, `e_source_registry_free_display_tree()` does all that in one step.

[skip]

#### Parameters

registry | an ESourceRegistry |
extension_name | an extension name, or `NULL`. | [nullable]

#### Returns

a tree of sources, arranged for display.

[element-type ESource][transfer full]

Since: 3.6

### e_source_registry_free_display_tree ()

    void
    e_source_registry_free_display_tree (GNode *display_tree);

Convenience function to free a GNode tree of registered sources created by `e_source_registry_build_display_tree()`.

#### Parameters

display_tree | a tree of sources, arranged for display |

Since: 3.6

### e_source_registry_dup_unique_display_name ()

    gchar *
    e_source_registry_dup_unique_display_name
                                   (ESourceRegistry *registry,
                                    ESource *source,
                                    const gchar *extension_name);

Compares `source` 's “display-name” against other sources having an ESourceExtension named `extension_name` , if given, or else against all other sources in the `registry` .

If `sources` 's “display-name” is unique among these other sources, the function will return the “display-name” verbatim. Otherwise the function will construct a string that includes the `sources` 's own “display-name” as well as those of its ancestors.

The function's return value is intended to be used in messages shown to the user to help clarify which source is being referred to. It assumes `source` 's “display-name” is at least unique among its siblings.

Free the returned string with `g_free()` when finished with it.

#### Parameters

registry | an ESourceRegistry |
source | an ESource |
extension_name | an extension name, or `NULL`. | [nullable]

#### Returns

a unique display name for `source`

Since: 3.8

### e_source_registry_debug_dump ()

    void
    e_source_registry_debug_dump (ESourceRegistry *registry,
                                  const gchar *extension_name);

Handy debugging function that uses `e_source_registry_build_display_tree()` to print a tree of registered sources to standard output.

#### Parameters

registry | an ESourceRegistry |
extension_name | an extension name, or `NULL`. | [nullable]

Since: 3.6

### e_source_registry_ref_builtin_address_book ()

    ESource *
    e_source_registry_ref_builtin_address_book
                                   (ESourceRegistry *registry);

Returns the built-in address book ESource.

This ESource is always present and makes for a safe fallback.

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

#### Parameters

registry | an ESourceRegistry |

#### Returns

the built-in address book ESource.

[transfer full]

Since: 3.6

### e_source_registry_ref_builtin_calendar ()

    ESource *
    e_source_registry_ref_builtin_calendar
                                   (ESourceRegistry *registry);

Returns the built-in calendar ESource.

This ESource is always present and makes for a safe fallback.

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

#### Parameters

registry | an ESourceRegistry |

#### Returns

the built-in calendar ESource.

[transfer full]

Since: 3.6

### e_source_registry_ref_builtin_mail_account ()

    ESource *
    e_source_registry_ref_builtin_mail_account
                                   (ESourceRegistry *registry);

Returns the built-in mail account ESource.

This ESource is always present and makes for a safe fallback.

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

#### Parameters

registry | an ESourceRegistry |

#### Returns

the built-in mail account ESource.

[transfer full]

Since: 3.6

### e_source_registry_ref_builtin_memo_list ()

    ESource *
    e_source_registry_ref_builtin_memo_list
                                   (ESourceRegistry *registry);

Returns the built-in memo list ESource.

This ESource is always present and makes for a safe fallback.

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

#### Parameters

registry | an ESourceRegistry |

#### Returns

the built-in memo list ESource.

[transfer full]

Since: 3.6

### e_source_registry_ref_builtin_proxy ()

    ESource *
    e_source_registry_ref_builtin_proxy (ESourceRegistry *registry);

Returns the built-in proxy profile ESource.

This ESource is always present and makes for a safe fallback.

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

#### Parameters

registry | an ESourceRegistry |

#### Returns

the built-in proxy profile ESource.

[transfer full]

Since: 3.12

### e_source_registry_ref_builtin_task_list ()

    ESource *
    e_source_registry_ref_builtin_task_list
                                   (ESourceRegistry *registry);

Returns the built-in task list ESource.

This ESource is always present and makes for a safe fallback.

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

#### Parameters

registry | an ESourceRegistry |

#### Returns

the built-in task list ESource.

[transfer full]

Since: 3.6

### e_source_registry_ref_default_address_book ()

    ESource *
    e_source_registry_ref_default_address_book
                                   (ESourceRegistry *registry);

Returns the ESource most recently passed to `e_source_registry_set_default_address_book()` either in this session or a previous session, or else falls back to the built-in address book.

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

#### Parameters

registry | an ESourceRegistry |

#### Returns

the default address book ESource.

[transfer full]

Since: 3.6

### e_source_registry_set_default_address_book ()

    void
    e_source_registry_set_default_address_book
                                   (ESourceRegistry *registry,
                                    ESource *default_source);

Sets `default_source` as the default address book. If `default_source` is `NULL`, the default address book is reset to the built-in address book. This setting will persist across sessions until changed.

#### Parameters

registry | an ESourceRegistry |
default_source | an address book ESource, or `NULL`. | [nullable]

Since: 3.6

### e_source_registry_ref_default_calendar ()

    ESource *
    e_source_registry_ref_default_calendar
                                   (ESourceRegistry *registry);

Returns the ESource most recently passed to `e_source_registry_set_default_calendar()` either in this session or a previous session, or else falls back to the built-in calendar.

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

#### Parameters

registry | an ESourceRegistry |

#### Returns

the default calendar ESource.

[transfer full]

Since: 3.6

### e_source_registry_set_default_calendar ()

    void
    e_source_registry_set_default_calendar
                                   (ESourceRegistry *registry,
                                    ESource *default_source);

Sets `default_source` as the default calendar. If `default_source` is `NULL`, the default calendar is reset to the built-in calendar. This setting will persist across sessions until changed.

#### Parameters

registry | an ESourceRegistry |
default_source | a calendar ESource, or `NULL`. | [nullable]

Since: 3.6

### e_source_registry_ref_default_mail_account ()

    ESource *
    e_source_registry_ref_default_mail_account
                                   (ESourceRegistry *registry);

Returns the ESource most recently passed to `e_source_registry_set_default_mail_account()` either in this session or a previous session, or else falls back to the built-in mail account.

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

#### Parameters

registry | an ESourceRegistry |

#### Returns

the default mail account ESource.

[transfer full]

Since: 3.6

### e_source_registry_set_default_mail_account ()

    void
    e_source_registry_set_default_mail_account
                                   (ESourceRegistry *registry,
                                    ESource *default_source);

Sets `default_source` as the default mail account. If `default_source` is `NULL`, the default mail account is reset to the built-in mail account. This setting will persist across sessions until changed.

#### Parameters

registry | an ESourceRegistry |
default_source | a mail account ESource, or `NULL`. | [nullable]

Since: 3.6

### e_source_registry_ref_default_mail_identity ()

    ESource *
    e_source_registry_ref_default_mail_identity
                                   (ESourceRegistry *registry);

Returns the ESource most recently passed to `e_source_registry_set_default_mail_identity()` either in this session or a previous session, or else falls back to the mail identity named by the default mail account. If even that fails it returns any mail identity from `registry` , or `NULL` if there are none.

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

#### Parameters

registry | an ESourceRegistry |

#### Returns

the default mail identity ESource, or `NULL`.

[transfer full][nullable]

Since: 3.6

### e_source_registry_set_default_mail_identity ()

    void
    e_source_registry_set_default_mail_identity
                                   (ESourceRegistry *registry,
                                    ESource *default_source);

Sets `default_source` as the default mail identity. If `default_source` is `NULL`, the next request for the default mail identity will use the fallbacks described in `e_source_registry_ref_default_mail_identity()`.

#### Parameters

registry | an ESourceRegistry |
default_source | a mail identity ESource, or `NULL`. | [nullable]

Since: 3.6

### e_source_registry_ref_default_memo_list ()

    ESource *
    e_source_registry_ref_default_memo_list
                                   (ESourceRegistry *registry);

Returns the ESource most recently passed to `e_source_registry_set_default_memo_list()` either in this session or a previous session, or else falls back to the built-in memo list.

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

#### Parameters

registry | an ESourceRegistry |

#### Returns

the default memo list ESource.

[transfer full]

Since: 3.6

### e_source_registry_set_default_memo_list ()

    void
    e_source_registry_set_default_memo_list
                                   (ESourceRegistry *registry,
                                    ESource *default_source);

Sets `default_source` as the default memo list. If `default_source` is `NULL`, the default memo list is reset to the built-in memo list. This setting will persist across sessions until changed.

#### Parameters

registry | an ESourceRegistry |
default_source | a memo list ESource, or `NULL`. | [nullable]

Since: 3.6

### e_source_registry_ref_default_task_list ()

    ESource *
    e_source_registry_ref_default_task_list
                                   (ESourceRegistry *registry);

Returns the ESource most recently passed to `e_source_registry_set_default_task_list()` either in this session or a previous session, or else falls back to the built-in task list.

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

#### Parameters

registry | an ESourceRegistry |

#### Returns

the default task list ESource.

[transfer full]

Since: 3.6

### e_source_registry_set_default_task_list ()

    void
    e_source_registry_set_default_task_list
                                   (ESourceRegistry *registry,
                                    ESource *default_source);

Sets `default_source` as the default task list. If `default_source` is `NULL`, the default task list is reset to the built-in task list. This setting will persist across sessions until changed.

#### Parameters

registry | an ESourceRegistry |
default_source | a task list ESource, or `NULL`. | [nullable]

Since: 3.6

### e_source_registry_ref_default_for_extension_name ()

    ESource *
    e_source_registry_ref_default_for_extension_name
                                   (ESourceRegistry *registry,
                                    const gchar *extension_name);

This is a convenience function to return a default ESource based on `extension_name` . This only works with a subset of extension names.

If `extension_name` is E_SOURCE_EXTENSION_ADDRESS_BOOK, the function returns the current default address book, or else falls back to the built-in address book.

If `extension_name` is E_SOURCE_EXTENSION_CALENDAR, the function returns the current default calendar, or else falls back to the built-in calendar.

If `extension_name` is E_SOURCE_EXTENSION_MAIL_ACCOUNT, the function returns the current default mail account, or else falls back to the built-in mail account.

If `extension_name` is E_SOURCE_EXTENSION_MAIL_IDENTITY, the function returns the current default mail identity, or else falls back to the mail identity named by the current default mail account.

If `extension_name` is E_SOURCE_EXTENSION_MEMO_LIST, the function returns the current default memo list, or else falls back to the built-in memo list.

If `extension_name` is E_SOURCE_EXTENSION_TASK_LIST, the function returns the current default task list, or else falls back to the built-in task list.

For all other values of `extension_name` , the function returns `NULL`.

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

#### Parameters

registry | an ESourceRegistry |
extension_name | an extension_name |

#### Returns

the default ESource based on `extension_name` .

[transfer full][nullable]

Since: 3.6

### e_source_registry_set_default_for_extension_name ()

    void
    e_source_registry_set_default_for_extension_name
                                   (ESourceRegistry *registry,
                                    const gchar *extension_name,
                                    ESource *default_source);

This is a convenience function to set a default ESource based on `extension_name` . This only works with a subset of extension names.

If `extension_name` is E_SOURCE_EXTENSION_ADDRESS_BOOK, the function sets `default_source` as the default address book. If `default_source` is `NULL`, the default address book is reset to the built-in address book.

If `extension_name` is E_SOURCE_EXTENSION_CALENDAR, the function sets `default_source` as the default calendar. If `default_source` is `NULL`, the default calendar is reset to the built-in calendar.

If `extension_name` is E_SOURCE_EXTENSION_MAIL_ACCOUNT, the function sets `default_source` as the default mail account. If `default_source` is `NULL`, the default mail account is reset to the built-in mail account.

If `extension_name` is E_SOURCE_EXTENSION_MAIL_IDENTITY, the function sets `default_source` as the default mail identity. If `default_source` is `NULL`, the next request for the default mail identity will return the mail identity named by the default mail account.

If `extension_name` is E_SOURCE_EXTENSION_MEMO_LIST, the function sets `default_source` as the default memo list. If `default_source` is `NULL`, the default memo list is reset to the built-in memo list.

If `extension_name` is E_SOURCE_EXTENSION_TASK_LIST, the function sets `default_source` as the default task list. If `default_source` is `NULL`, the default task list is reset to the built-in task list.

For all other values of `extension_name` , the function does nothing.

#### Parameters

registry | an ESourceRegistry |
extension_name | an extension name |
default_source | an ESource, or `NULL`. | [nullable]

Since: 3.6

## Types and Values

### struct ESourceRegistry

    struct ESourceRegistry;

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

Since: 3.6