## Item Information

Item Information — Keyring Item Info

## Synopsis

    enum                MateKeyringItemType;
    typedef             MateKeyringItemInfo;
    void                mate_keyring_item_info_free        (MateKeyringItemInfo *item_info);
    MateKeyringItemInfo * mate_keyring_item_info_new      (void);
    MateKeyringItemInfo * mate_keyring_item_info_copy     (MateKeyringItemInfo *item_info);
    MateKeyringItemType  mate_keyring_item_info_get_type  (MateKeyringItemInfo *item_info);
    void                mate_keyring_item_info_set_type    (MateKeyringItemInfo *item_info,
                                                             MateKeyringItemType type);
    char *              mate_keyring_item_info_get_secret  (MateKeyringItemInfo *item_info);
    void                mate_keyring_item_info_set_secret  (MateKeyringItemInfo *item_info,
                                                             const char *value);
    char *              mate_keyring_item_info_get_display_name
                                                            (MateKeyringItemInfo *item_info);
    void                mate_keyring_item_info_set_display_name
                                                            (MateKeyringItemInfo *item_info,
                                                             const char *value);
    time_t              mate_keyring_item_info_get_mtime   (MateKeyringItemInfo *item_info);
    time_t              mate_keyring_item_info_get_ctime   (MateKeyringItemInfo *item_info);

## Description

MateKeyringItemInfo represents the basic information about a keyring item. Use `mate_keyring_item_get_info()` or `mate_keyring_item_set_info()`.

## Details

### enum MateKeyringItemType

    typedef enum {

    	/* The item types */
    	MATE_KEYRING_ITEM_GENERIC_SECRET = 0,
    	MATE_KEYRING_ITEM_NETWORK_PASSWORD,
    	MATE_KEYRING_ITEM_NOTE,
    	MATE_KEYRING_ITEM_CHAINED_KEYRING_PASSWORD,
    	MATE_KEYRING_ITEM_ENCRYPTION_KEY_PASSWORD,

    	MATE_KEYRING_ITEM_PK_STORAGE = 0x100,

    	/* Not used, remains here only for compatibility */
    	MATE_KEYRING_ITEM_LAST_TYPE,

    } MateKeyringItemType;

### MateKeyringItemInfo

    typedef struct MateKeyringItemInfo MateKeyringItemInfo;

### mate_keyring_item_info_free ()

    void                mate_keyring_item_info_free        (MateKeyringItemInfo *item_info);

Free the MateKeyringItemInfo object.

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

`item_info` : | The keyring item info pointer.

### mate_keyring_item_info_new ()

    MateKeyringItemInfo * mate_keyring_item_info_new      (void);

Create a new MateKeyringItemInfo object. Free the MateKeyringItemInfo object.

Returns : | A keyring item info pointer.

### mate_keyring_item_info_copy ()

    MateKeyringItemInfo * mate_keyring_item_info_copy     (MateKeyringItemInfo *item_info);

Copy a MateKeyringItemInfo object.

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

### mate_keyring_item_info_get_type ()

    MateKeyringItemType  mate_keyring_item_info_get_type  (MateKeyringItemInfo *item_info);

Get the item type.

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

### mate_keyring_item_info_set_type ()

    void                mate_keyring_item_info_set_type    (MateKeyringItemInfo *item_info,
                                                             MateKeyringItemType type);

Set the type on an item info.

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

### mate_keyring_item_info_get_secret ()

    char *              mate_keyring_item_info_get_secret  (MateKeyringItemInfo *item_info);

Get the item secret.

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

### mate_keyring_item_info_set_secret ()

    void                mate_keyring_item_info_set_secret  (MateKeyringItemInfo *item_info,
                                                             const char *value);

Set the secret on an item info.

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

### mate_keyring_item_info_get_display_name ()

    char *              mate_keyring_item_info_get_display_name
                                                            (MateKeyringItemInfo *item_info);

Get the item display name.

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

### mate_keyring_item_info_set_display_name ()

    void                mate_keyring_item_info_set_display_name
                                                            (MateKeyringItemInfo *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.

### mate_keyring_item_info_get_mtime ()

    time_t              mate_keyring_item_info_get_mtime   (MateKeyringItemInfo *item_info);

Get the item last modified time.

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

### mate_keyring_item_info_get_ctime ()

    time_t              mate_keyring_item_info_get_ctime   (MateKeyringItemInfo *item_info);

Get the item created time.

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