hash table of D-Bus properties for the new collection
an alias to check for before creating the new collection, or to assign to the new collection
not currently used
optional cancellation object
a new string containing the D-Bus object path of the collection
GException on failure.
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 secret_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 <literal>org.freedesktop.Secret.Collection.Label</literal>. The values in the hash table should be #GVariant 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. secret_service_prompt() will be used to handle any prompts that are required.