Item Information

## Item Information Item Information — Keyring Item Info |

## Synopsis

    enum                GnomeKeyringItemType;
    typedef             GnomeKeyringItemInfo;
    void                gnome_keyring_item_info_free        (GnomeKeyringItemInfo *item_info);
    GnomeKeyringItemInfo * gnome_keyring_item_info_new      (void);
    GnomeKeyringItemInfo * gnome_keyring_item_info_copy     (GnomeKeyringItemInfo *item_info);
    GnomeKeyringItemType gnome_keyring_item_info_get_type   (GnomeKeyringItemInfo *item_info);
    void                gnome_keyring_item_info_set_type    (GnomeKeyringItemInfo *item_info,
                                                             GnomeKeyringItemType type);
    char *              gnome_keyring_item_info_get_secret  (GnomeKeyringItemInfo *item_info);
    void                gnome_keyring_item_info_set_secret  (GnomeKeyringItemInfo *item_info,
                                                             const char *value);
    char *              gnome_keyring_item_info_get_display_name
                                                            (GnomeKeyringItemInfo *item_info);
    void                gnome_keyring_item_info_set_display_name
                                                            (GnomeKeyringItemInfo *item_info,
                                                             const char *value);
    time_t              gnome_keyring_item_info_get_mtime   (GnomeKeyringItemInfo *item_info);
    time_t              gnome_keyring_item_info_get_ctime   (GnomeKeyringItemInfo *item_info);

## Description

### Warning

All of these APIs are deprecated. Use libsecret instead.

GnomeKeyringItemInfo represents the basic information about a keyring item. Use `gnome_keyring_item_get_info()` or `gnome_keyring_item_set_info()`.

## Details

### enum GnomeKeyringItemType

    typedef enum {
    	/* The item types */
    	GNOME_KEYRING_ITEM_GENERIC_SECRET = 0,
    	GNOME_KEYRING_ITEM_NETWORK_PASSWORD,
    	GNOME_KEYRING_ITEM_NOTE,
    	GNOME_KEYRING_ITEM_CHAINED_KEYRING_PASSWORD,
    	GNOME_KEYRING_ITEM_ENCRYPTION_KEY_PASSWORD,

    	GNOME_KEYRING_ITEM_PK_STORAGE = 0x100,

    	/* Not used, remains here only for compatibility */
    	GNOME_KEYRING_ITEM_LAST_TYPE,
    } GnomeKeyringItemType;

### Warning

`GnomeKeyringItemType` is deprecated and should not be used in newly-written code. Use SecretSchema instead.

The types of items.

`GNOME_KEYRING_ITEM_GENERIC_SECRET` | Generic secret
`GNOME_KEYRING_ITEM_NETWORK_PASSWORD` | Network password
`GNOME_KEYRING_ITEM_NOTE` | Note
`GNOME_KEYRING_ITEM_CHAINED_KEYRING_PASSWORD` | Keyring password
`GNOME_KEYRING_ITEM_ENCRYPTION_KEY_PASSWORD` | Password for encryption key
`GNOME_KEYRING_ITEM_PK_STORAGE` | Key storage password
`GNOME_KEYRING_ITEM_LAST_TYPE` | Not used

### GnomeKeyringItemInfo

    typedef struct GnomeKeyringItemInfo GnomeKeyringItemInfo;

### Warning

`GnomeKeyringItemInfo` is deprecated and should not be used in newly-written code.

### gnome_keyring_item_info_free ()

    void                gnome_keyring_item_info_free        (GnomeKeyringItemInfo *item_info);

### Warning

`gnome_keyring_item_info_free` is deprecated and should not be used in newly-written code. Use SecretItem objects instead.

Free the GnomeKeyringItemInfo object.

A `NULL` pointer may be passed, in which case it will be ignored.

`item_info` : | The keyring item info pointer.

### gnome_keyring_item_info_new ()

    GnomeKeyringItemInfo * gnome_keyring_item_info_new      (void);

### Warning

`gnome_keyring_item_info_new` is deprecated and should not be used in newly-written code. Use SecretItem objects instead.

Create a new GnomeKeyringItemInfo object. Free the GnomeKeyringItemInfo object.

Returns : | A keyring item info pointer.

### gnome_keyring_item_info_copy ()

    GnomeKeyringItemInfo * gnome_keyring_item_info_copy     (GnomeKeyringItemInfo *item_info);

### Warning

`gnome_keyring_item_info_copy` is deprecated and should not be used in newly-written code. Use SecretItem objects instead.

Copy a GnomeKeyringItemInfo object.

`item_info` : | A keyring item info pointer.
Returns : | A keyring item info pointer.

### gnome_keyring_item_info_get_type ()

    GnomeKeyringItemType gnome_keyring_item_info_get_type   (GnomeKeyringItemInfo *item_info);

### Warning

`gnome_keyring_item_info_get_type` is deprecated and should not be used in newly-written code. Use `secret_item_get_schema_name()` instead.

Get the item type.

`item_info` : | A keyring item info pointer.
Returns : | The item type

### gnome_keyring_item_info_set_type ()

    void                gnome_keyring_item_info_set_type    (GnomeKeyringItemInfo *item_info,
                                                             GnomeKeyringItemType type);

### Warning

`gnome_keyring_item_info_set_type` is deprecated and should not be used in newly-written code. Use `secret_item_set_attributes()` instead.

Set the type on an item info.

`item_info` : | A keyring item info pointer.
`type` : | The new item type

### gnome_keyring_item_info_get_secret ()

    char *              gnome_keyring_item_info_get_secret  (GnomeKeyringItemInfo *item_info);

### Warning

`gnome_keyring_item_info_get_secret` is deprecated and should not be used in newly-written code. Use `secret_item_get_secret()` instead.

Get the item secret.

`item_info` : | A keyring item info pointer.
Returns : | The newly allocated string containing the item secret.

### gnome_keyring_item_info_set_secret ()

    void                gnome_keyring_item_info_set_secret  (GnomeKeyringItemInfo *item_info,
                                                             const char *value);

### Warning

`gnome_keyring_item_info_set_secret` is deprecated and should not be used in newly-written code. Use `secret_item_set_secret()` instead.

Set the secret on an item info.

`item_info` : | A keyring item info pointer.
`value` : | The new item secret

### gnome_keyring_item_info_get_display_name ()

    char *              gnome_keyring_item_info_get_display_name
                                                            (GnomeKeyringItemInfo *item_info);

### Warning

`gnome_keyring_item_info_get_display_name` is deprecated and should not be used in newly-written code. Use `secret_item_get_label()` instead.

Get the item display name.

`item_info` : | A keyring item info pointer.
Returns : | The newly allocated string containing the item display name.

### gnome_keyring_item_info_set_display_name ()

    void                gnome_keyring_item_info_set_display_name
                                                            (GnomeKeyringItemInfo *item_info,
                                                             const char *value);

### Warning

`gnome_keyring_item_info_set_display_name` is deprecated and should not be used in newly-written code. Use `secret_item_set_label()` instead.

Set the display name on an item info.

`item_info` : | A keyring item info pointer.
`value` : | The new display name.

### gnome_keyring_item_info_get_mtime ()

    time_t              gnome_keyring_item_info_get_mtime   (GnomeKeyringItemInfo *item_info);

### Warning

`gnome_keyring_item_info_get_mtime` is deprecated and should not be used in newly-written code. Use `secret_item_get_modified()` instead.

Get the item last modified time.

`item_info` : | A keyring item info pointer.
Returns : | The item last modified time.

### gnome_keyring_item_info_get_ctime ()

    time_t              gnome_keyring_item_info_get_ctime   (GnomeKeyringItemInfo *item_info);

### Warning

`gnome_keyring_item_info_get_ctime` is deprecated and should not be used in newly-written code. Use `secret_item_get_created()` instead.

Get the item created time.

`item_info` : | A keyring item info pointer.
Returns : | The item created time.