e_webdav_discover_free_discovered_sources ()

void
e_webdav_discover_free_discovered_sources
                               (GSList *discovered_sources);

Frees a GSList of discovered sources returned from e_webdav_discover_sources_finish() or e_webdav_discover_sources_sync().

Since: 3.18

e_webdav_discover_sources ()

void
e_webdav_discover_sources (ESource *source,
                           const gchar *url_use_path,
                           guint32 only_supports,
                           const ENamedParameters *credentials,
                           GCancellable *cancellable,
                           GAsyncReadyCallback callback,
                           gpointer user_data);

Asynchronously runs discovery of the WebDAV sources (CalDAV and CardDAV), eventually limited by the only_supports filter, which can be E_WEBDAV_DISCOVER_SUPPORTS_NONE to search all types. Note that the list of returned calendars can be more general, thus check for its actual support type for further filtering of the results. The url_use_path can be used to override actual server path, or even complete URL, for the given source .

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

Since: 3.18

e_webdav_discover_sources_finish ()

gboolean
e_webdav_discover_sources_finish (ESource *source,
                                  GAsyncResult *result,
                                  gchar **out_certificate_pem,
                                  GTlsCertificateFlags *out_certificate_errors,
                                  GSList **out_discovered_sources,
                                  GSList **out_calendar_user_addresses,
                                  GError **error);

Finishes the operation started with e_webdav_discover_sources(). If an error occurred, the function will set error and return FALSE. The function can return success and no discovered sources, the same as it can return failure, but still set some output arguments, like the certificate related output arguments with SOUP_STATUS_SSL_FAILED error.

The return value of out_certificate_pem should be freed with g_free() when no longer needed.

The return value of out_discovered_sources should be freed with e_webdav_discover_free_discovered_sources() when no longer needed.

The return value of out_calendar_user_addresses should be freed with g_slist_free_full (calendar_user_addresses, g_free); when no longer needed.

Since: 3.18

e_webdav_discover_sources_sync ()

gboolean
e_webdav_discover_sources_sync (ESource *source,
                                const gchar *url_use_path,
                                guint32 only_supports,
                                const ENamedParameters *credentials,
                                gchar **out_certificate_pem,
                                GTlsCertificateFlags *out_certificate_errors,
                                GSList **out_discovered_sources,
                                GSList **out_calendar_user_addresses,
                                GCancellable *cancellable,
                                GError **error);

Synchronously runs discovery of the WebDAV sources (CalDAV and CardDAV), eventually limited by the only_supports filter, which can be E_WEBDAV_DISCOVER_SUPPORTS_NONE to search all types. Note that the list of returned calendars can be more general, thus check for its actual support type for further filtering of the results. The url_use_path can be used to override actual server path, or even complete URL, for the given source .

If an error occurred, the function will set error and return FALSE. The function can return success and no discovered sources, the same as it can return failure, but still set some output arguments, like the certificate related output arguments with SOUP_STATUS_SSL_FAILED error.

The return value of out_certificate_pem should be freed with g_free() when no longer needed.

The return value of out_discovered_sources should be freed with e_webdav_discover_free_discovered_sources() when no longer needed.

The return value of out_calendar_user_addresses should be freed with g_slist_free_full (calendar_user_addresses, g_free); when no longer needed.

Since: 3.18

enum EWebDAVDiscoverSupports

EWebDAVDiscoveredSource

typedef struct {
	gchar *href;
	guint32 supports;
	gchar *display_name;
	gchar *description;
	gchar *color;
} EWebDAVDiscoveredSource;