create_sync


Description:

public static Collection create_sync (Service? service, string label, string? alias, CollectionCreateFlags flags, Cancellable? cancellable = null) throws Error

Create a new collection in the secret service.

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.

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 you specify an alias, and a collection with that alias already exists, then a new collection will not be created. The previous one will be returned instead.

If service is null, then [funcService.get_sync] will be called to get the default [class Service] proxy.

Parameters:

service

a secret service object

label

label for the new collection

alias

alias to assign to the collection

flags

currently unused

cancellable

optional cancellation object

Returns:

the new collection, which should be unreferenced with [methodGObject.Object.unref]




2022 vala-language.org