principal_property_search_sync

Description:

public bool principal_property_search_sync (string? uri, bool apply_to_principal_collection_set, string? match_ns_uri, string match_property, string match_value, out SList<WebDAVResource> out_principals, Cancellable? cancellable = null) throws Error

Issues a DAV:principal-property-search for the uri, or, in case it's null, for the URI defined in associated Source.

The DAV:principal-property-search performs a search for all principals whose properties contain character data that matches the search criteria match_value in match_property property of namespace match_ns_uri.

By default, the function searches all members (at any depth) of the collection identified by the uri. If apply_to_principal_collection_set is set to true, the search is applied instead to each collection returned by get_principal_collection_set_sync for the uri.

The out_principals is a SList of WebDAVResource, where the kind is set to PRINCIPAL and only href with displayname are filled. All other members of WebDAVResource are not set.

Free the returned out_principals with g_slist_free_full (principals, e_webdav_resource_free); when no longer needed.

Parameters:

this	an WebDAVSession
uri	URI to issue the request for, or `null` to read from Source
apply_to_principal_collection_set	whether to apply to principal-collection-set
match_ns_uri	namespace URI of the property to search in, or `null` for WEBDAV_NS_DAV
match_property	name of the property to search in
match_value	a string value to search for
out_principals	return location for matching principals
cancellable	optional Cancellable object, or `null`

Returns:

Whether succeeded. Note it can report success also when no matching principal had been found.