Function
SecretCollectioncreate_sync
Declaration [src]
SecretCollection*
secret_collection_create_sync (
SecretService* service,
const gchar* label,
const gchar* alias,
SecretCollectionCreateFlags flags,
GCancellable* cancellable,
GError** error
)
Description [src]
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. secret_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 secret_service_get_sync()
will be called to get the
default SecretService
proxy.
Parameters
service |
SecretService |
A secret service object. |
|
The argument can be NULL . | |
The data is owned by the caller of the function. | |
label |
const gchar* |
Label for the new collection. |
|
The data is owned by the caller of the function. | |
The value is a NUL terminated UTF-8 string. | |
alias |
const gchar* |
Alias to assign to the 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 |
Currently unused. |
|
cancellable |
GCancellable |
Optional cancellation object. |
|
The argument can be NULL . | |
The data is owned by the caller of the function. | |
error |
GError ** |
The return location for a GError* , or NULL . |
Return value
Returns: | SecretCollection |
The new collection, which should be unreferenced
with |
|
The caller of the function takes ownership of the data, and is responsible for freeing it. |