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 throws 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 G_TLS_ERROR_BAD_CERTIFICATE 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
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.
| url_use_path |
optional URL override, or null |
| only_supports |
bit-or of EWebDAVDiscoverSupports, to limit what type of sources to search |
| credentials |
credentials to use for authentication to the server |
| out_certificate_pem |
optional return location for a server SSL certificate in PEM format, when the operation failed with an SSL error |
| out_certificate_errors |
optional TlsCertificateFlags, with certificate error flags when the operation failed with SSL error |
| out_discovered_sources |
a SList of all discovered sources |
| out_calendar_user_addresses |
a SList of all discovered mail addresses for calendar sources |
| cancellable |
optional Cancellable object, or null |
| source |
an Source from which to take connection details |
|
true on success, false on failure |