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.