Service.createItemDbusPathSync

Create a new item in a secret service collection and return its D-Bus object path.

It is often easier to use secret_password_store_sync() or secret_item_create_sync() rather than using this function. Using this method requires that you setup a correct hash table of D-Bus @properties for the new collection.

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.

@properties is a set of properties for the new collection. The keys in the hash table should be interface.property strings like <literal>org.freedesktop.Secret.Item.Label</literal>. The values in the hash table should be #GVariant values of the properties.

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.

class Service
string
createItemDbusPathSync
(,
HashTable properties
,,
SecretItemCreateFlags flags
,
Cancellable cancellable
)

Parameters

collectionPath string

the D-Bus path of the collection in which to create item

properties HashTable

hash table of D-Bus properties for the new collection

value Value

the secret value to store in the item

flags SecretItemCreateFlags

flags for the creation of the new item

cancellable Cancellable

optional cancellation object

Return Value

Type: string

a new string containing the D-Bus object path of the item

Throws

GException on failure.

Meta