## 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

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;

### GnomeKeyringItemInfo

    typedef struct GnomeKeyringItemInfo GnomeKeyringItemInfo;

### gnome_keyring_item_info_free ()

    void                gnome_keyring_item_info_free        (GnomeKeyringItemInfo *item_info);

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);

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);

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);

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);

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);

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);

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);

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);

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);

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);

Get the item created time.

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