item was created.
secret.retrievable_mixin
Module for Retrievable interface mixin
Templates 2
tmplRetrievableT()
A read-only view of a secret item in the Secret Service.
#SecretRetrievable provides a read-only view of a secret item stored in the Secret Service.
Each item has a value, represented by a secret.value.Value, which can be retrieved by secret.retrievable.Retrievable.retrieveSecret and secret.retrievable.Retrievable.retrieveSecretFinish.
Functions
ulong created()
Get created property.
Returns
The date and time (in seconds since the UNIX epoch) that this
void created(ulong propval)
Set created property.
Parameters
propval | The date and time (in seconds since the UNIX epoch) that this item was created. |
string label()
Get label property.
Returns
The human readable label for the item.
void label(string propval)
Set label property.
Parameters
propval | The human readable label for the item. |
ulong modified()
Get modified property.
Returns
The date and time (in seconds since the UNIX epoch) that this
item was last modified.
void modified(ulong propval)
Set modified property.
Parameters
propval | The date and time (in seconds since the UNIX epoch) that this item was last modified. |
string[string] getAttributes()
Get the attributes of this object.
The attributes are a mapping of string keys to string values. Attributes are used to search for items. Attributes are not stored or transferred securely by the secret service.
Do not modify the attribute returned by this method.
Returns
a new reference
to the attributes, which should not be modified, and released with glib.hash_table.HashTable.unref
ulong getCreated()
Get the created date and time of the object.
The return value is the number of seconds since the unix epoch, January 1st 1970.
Returns
the created date and time
string getLabel()
Get the label of this item.
Returns
the label, which should be freed with
funcGLib.freeulong getModified()
Get the modified date and time of the object.
The return value is the number of seconds since the unix epoch, January 1st 1970.
Returns
the modified date and time
void retrieveSecret(gio.cancellable.Cancellable cancellable = null, gio.types.AsyncReadyCallback callback = null)
Retrieve the secret value of this object.
Each retrievable object has a single secret which might be a password or some other secret binary value.
This function returns immediately and completes asynchronously.
Parameters
cancellable | optional cancellation object |
callback | called when the operation completes |
secret.value.Value retrieveSecretFinish(gio.async_result.AsyncResult result)
Complete asynchronous operation to retrieve the secret value of this object.
Parameters
result | asynchronous result passed to callback |
Returns
the secret value which should be
released with secret.value.Value.unref, or null
Throws
secret.value.Value retrieveSecretSync(gio.cancellable.Cancellable cancellable = null)
Retrieve the secret value of this object synchronously.
Each retrievable object has a single secret which might be a password or some other secret binary value.
This method may block indefinitely and should not be used in user interface threads.
Parameters
cancellable | optional cancellation object |
Returns
the secret value which should be
released with secret.value.Value.unref, or null
Throws
tmplRetrievableGidBuilderT()
Fluent builder implementation template for secret.retrievable.Retrievable
Functions
T created(ulong propval)
Set created property.
Parameters
propval | The date and time (in seconds since the UNIX epoch) that this item was created. |
Returns
Builder instance for fluent chaining
T label(string propval)
Set label property.
Parameters
propval | The human readable label for the item. |
Returns
Builder instance for fluent chaining
T modified(ulong propval)
Set modified property.
Parameters
propval | The date and time (in seconds since the UNIX epoch) that this item was last modified. |
Returns
Builder instance for fluent chaining