Method
SecretServicecreate_collection_dbus_path
Declaration [src]
void
secret_service_create_collection_dbus_path (
SecretService* self,
GHashTable* properties,
const gchar* alias,
SecretCollectionCreateFlags flags,
GCancellable* cancellable,
GAsyncReadyCallback callback,
gpointer user_data
)
Description [src]
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
org.freedesktop.Secret.Collection.Label
. The values
in the hash table should be GVariant
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. secret_service_prompt()
will be used to handle
any prompts that are required.
Stability: | Unstable |
This method is not directly available to language bindings. |
Parameters
properties |
GHashTable |
Hash table of properties for the new collection. |
|
The data is owned by the caller of the function. | |
alias |
const gchar* |
An alias to check for before creating the new collection, or to assign to the new collection. |
|
The argument can be NULL . | |
The data is owned by the caller of the function. | |
The value is a NUL terminated UTF-8 string. | |
flags |
SecretCollectionCreateFlags |
Not currently used. |
|
cancellable |
GCancellable |
Optional cancellation object. |
|
The argument can be NULL . | |
The data is owned by the caller of the function. | |
callback |
GAsyncReadyCallback |
Called when the operation completes. |
|
The argument can be NULL . | |
user_data |
gpointer |
Data to be passed to the callback. |
|
The argument can be NULL . | |
The data is owned by the caller of the function. |