Create a new collection in the secret service and return its path.
Using this method requires that you setup a correct hash table of D-Bus properties for the new collection. You may prefer to use [func
Collection.create] which does handles this for you.
An alias is a well-known tag for a collection, such as 'default' (ie: the default collection to store items in). This allows
other applications to easily identify and share a collection. If a collection with the alias already exists, then instead of
creating a new collection, the existing collection will be returned. If no collection with this alias exists, then a new collection will
be created and this alias will be assigned to it.
properties is a set of properties for the new collection. The keys in the hash table should be interface.property strings
like `org.freedesktop.Secret.Collection.Label`. The values in the hash table should be [structGLib.Variant] values of the
properties.
This method may block indefinitely and should not be used in user interface threads. The secret service may prompt the user. [method
Service.prompt] will be used to handle any prompts that are required.
| this |
a secret service object |
| properties |
hash table of D-Bus properties for the new collection |
| alias |
an alias to check for before creating the new collection, or to assign to the new collection |
| flags |
not currently used |
| cancellable |
optional cancellation object |
|
a new string containing the D-Bus object path of the collection |