### Interface

# Secret Retrievable

since: 0.19.0

#### Description [src]

    interface Secret.Retrievable : GObject.Object

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 `SecretValue`, which can be retrieved by `secret_retrievable_retrieve_secret()` and `secret_retrievable_retrieve_secret_finish()`.

Stability: Stable

Available since: 0.19.0

#### Prerequisite

In order to implement Retrievable, your type must inherit from`GObject`.

#### Implementations

- SecretItem

#### Instance methods

###### secret_retrievable_get_attributes

Get the attributes of this object.

since: 0.19.0

###### secret_retrievable_get_created

Get the created date and time of the object.

since: 0.19.0

###### secret_retrievable_get_label

Get the label of this item.

since: 0.19.0

###### secret_retrievable_get_modified

Get the modified date and time of the object.

since: 0.19.0

###### secret_retrievable_retrieve_secret

Retrieve the secret value of this object.

since: 0.19.0

###### secret_retrievable_retrieve_secret_finish

Complete asynchronous operation to retrieve the secret value of this object.

since: 0.19.0

###### secret_retrievable_retrieve_secret_sync

Retrieve the secret value of this object synchronously.

since: 0.19.0

#### Properties

###### Secret.Retrievable:attributes

The attributes set on this item.

since: 0.19.0

###### Secret.Retrievable:created

The date and time (in seconds since the UNIX epoch) that this item was created.

since: 0.19.0

###### Secret.Retrievable:label

The human readable label for the item.

since: 0.19.0

###### Secret.Retrievable:modified

The date and time (in seconds since the UNIX epoch) that this item was last modified.

since: 0.19.0

#### Interface structure

    struct SecretRetrievableInterface {
      GTypeInterface parent_iface;
      void (* retrieve_secret) (
        SecretRetrievable* self,
        GCancellable* cancellable,
        GAsyncReadyCallback callback,
        gpointer user_data
      );
      SecretValue* (* retrieve_secret_finish) (
        SecretRetrievable* self,
        GAsyncResult* result,
        GError** error
      );

    }

The interface for `SecretRetrievable`.

###### Interface members

`parent_iface`

    GTypeInterface

| The parent interface.

`retrieve_secret`

    void (* retrieve_secret) (
        SecretRetrievable* self,
        GCancellable* cancellable,
        GAsyncReadyCallback callback,
        gpointer user_data
      )

| Implementation of `secret_retrievable_retrieve_secret()`, required.

`retrieve_secret_finish`

    SecretValue* (* retrieve_secret_finish) (
        SecretRetrievable* self,
        GAsyncResult* result,
        GError** error
      )

| Implementation of `secret_retrievable_retrieve_secret_finish()`, required.

#### Virtual methods

###### Secret.Retrievable.retrieve_secret

Retrieve the secret value of this object.

since: 0.19.0

###### Secret.Retrievable.retrieve_secret_finish

Complete asynchronous operation to retrieve the secret value of this object.

since: 0.19.0