create_collection_dbus_path


Description:

public async string create_collection_dbus_path (HashTable<string,Variant> properties, string? alias, CollectionCreateFlags flags, Cancellable? cancellable) throws Error

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.

If you wish to have a

This method will return immediately and complete asynchronously. The secret service may prompt the user. [methodService.prompt ] will be used to handle any prompts that are required.

Parameters:

this

a secret service object

properties

hash table of 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

callback

called when the operation completes

user_data

data to be passed to the callback




2022 vala-language.org