Top | ![]() |
![]() |
![]() |
![]() |
|
e_webdav_discover_free_discovered_sources () |
|
e_webdav_discover_sources () |
|
e_webdav_discover_sources_finish () |
|
e_webdav_discover_sources_sync () |
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()
.
discovered_sources |
A |
[element-type EWebDAVDiscoveredSource] |
Since: 3.18
void e_webdav_discover_sources (ESource *source
,const
,gchar *url_use_path,
guint32 only_supportsconst 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.
source |
an ESource from which to take connection details |
|
url_use_path |
optional URL override, or |
[allow-none] |
only_supports |
bit-or of EWebDAVDiscoverSupports, to limit what type of sources to search |
|
credentials |
credentials to use for authentication to the server. |
[allow-none] |
cancellable |
optional |
[allow-none] |
callback |
a |
[scope async] |
user_data |
data to pass to the callback function. |
[closure] |
Since: 3.18
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 return value of out_certificate_pem
should be freed with g_free()
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.
source |
an ESource on which the operation was started |
|
result |
a |
|
out_certificate_pem |
optional return location for a server SSL certificate in PEM format, when the operation failed with an SSL error. |
[out][allow-none] |
out_certificate_errors |
optional |
[out][allow-none] |
out_discovered_sources |
a |
[out][element-type EWebDAVDiscoveredSource] |
out_calendar_user_addresses |
a |
[out][allow-none][element-type utf8] |
error |
return location for a |
[allow-none] |
Since: 3.18
gboolean e_webdav_discover_sources_sync (ESource *source
,const
,gchar *url_use_path,
guint32 only_supportsconst 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 return value of out_certificate_pem
should be freed with g_free()
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.
source |
an ESource from which to take connection details |
|
url_use_path |
optional URL override, or |
[allow-none] |
only_supports |
bit-or of EWebDAVDiscoverSupports, to limit what type of sources to search |
|
credentials |
credentials to use for authentication to the server. |
[allow-none] |
out_certificate_pem |
optional return location for a server SSL certificate in PEM format, when the operation failed with an SSL error. |
[out][allow-none] |
out_certificate_errors |
optional |
[out][allow-none] |
out_discovered_sources |
a |
[out][element-type EWebDAVDiscoveredSource] |
out_calendar_user_addresses |
a |
[out][allow-none][element-type utf8] |
cancellable |
optional |
[allow-none] |
error |
return location for a |
[allow-none] |
Since: 3.18