Function
SecretCollectioncreate
Declaration [src]
void
secret_collection_create (
SecretService* service,
const gchar* label,
const gchar* alias,
SecretCollectionCreateFlags flags,
GCancellable* cancellable,
GAsyncReadyCallback callback,
gpointer user_data
)
Description [src]
Create a new collection in the secret service.
This method returns immediately and completes asynchronously. 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() will be called to get the
default SecretService proxy.
This function completes asynchronously. Use secret_collection_create_finish() inside the GAsyncReadyCallback to obtain the result of the operation.
Parameters
service-
Type:
SecretServiceA secret service object.
The argument can be NULL.The data is owned by the caller of the function. label-
Type:
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-
Type:
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-
Type:
SecretCollectionCreateFlagsCurrently unused.
cancellable-
Type:
GCancellableOptional cancellation object.
The argument can be NULL.The data is owned by the caller of the function. callback-
Type:
GAsyncReadyCallbackCalled when the operation completes.
user_data-
Type:
gpointerData to pass to the callback.
The argument can be NULL.The data is owned by the caller of the function.