Function
SecretItemcreate_sync
Declaration [src]
SecretItem*
secret_item_create_sync (
SecretCollection* collection,
const SecretSchema* schema,
GHashTable* attributes,
const gchar* label,
SecretValue* value,
SecretItemCreateFlags flags,
GCancellable* cancellable,
GError** error
)
Description [src]
Create a new item in the secret service.
If the flags
contains SECRET_ITEM_CREATE_REPLACE
, then the secret
service will search for an item matching the attributes
, and update that item
instead of creating a new one.
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.
Parameters
collection |
SecretCollection |
A secret collection to create this item in. |
|
The data is owned by the caller of the function. | |
schema |
SecretSchema |
The schema for the attributes. |
|
The argument can be NULL . | |
The data is owned by the caller of the function. | |
attributes |
GHashTable |
Attributes for the new item. |
|
The data is owned by the caller of the function. | |
label |
const gchar* |
Label for the new item. |
|
The data is owned by the caller of the function. | |
The value is a NUL terminated UTF-8 string. | |
value |
SecretValue |
Secret value for the new item. |
|
The data is owned by the caller of the function. | |
flags |
SecretItemCreateFlags |
Flags for the creation of the new item. |
|
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: | SecretItem |
The new item, which should be unreferenced
with |
|
The caller of the function takes ownership of the data, and is responsible for freeing it. |