Top |
Attributes allow various other pieces of information to be associated with an item.
These can also be used to search for relevant items. Use gnome_keyring_item_get_attributes()
or gnome_keyring_item_set_attributes()
.
Attributes are not stored in a secret or encrypted manner by gnome-keyring. Do not store sensitive information in attributes.
Each attribute has either a string, or unsigned integer value.
#define gnome_keyring_attribute_list_index(a, i)
gnome_keyring_attribute_list_index
is deprecated and should not be used in newly-written code.
GnomeKeyringAttributeList *
gnome_keyring_attribute_list_new (void
);
gnome_keyring_attribute_list_new
is deprecated and should not be used in newly-written code.
libsecret stores attributes as a GHashTable containing
string keys and values; use g_hash_table_new()
instead.
Create a new GnomeKeyringAttributeList.
void gnome_keyring_attribute_list_append_string (GnomeKeyringAttributeList *attributes
,const char *name
,const char *value
);
gnome_keyring_attribute_list_append_string
is deprecated and should not be used in newly-written code.
libsecret stores attributes as a GHashTable containing
string keys and values, use g_hash_table_replace()
instead.
Store a key-value-pair with a string value in attributes
.
void gnome_keyring_attribute_list_append_uint32 (GnomeKeyringAttributeList *attributes
,const char *name
,guint32 value
);
gnome_keyring_attribute_list_append_uint32
is deprecated and should not be used in newly-written code.
libsecret does not support number attributes.
Store a key-value-pair with an unsigned 32bit number value in attributes
.
void
gnome_keyring_attribute_list_free (GnomeKeyringAttributeList *attributes
);
gnome_keyring_attribute_list_free
is deprecated and should not be used in newly-written code.
libsecret stores attributes as a GHashTable containing
string keys and values, use g_hash_table_unref()
instead.
Free the memory used by attributes
.
If a NULL
pointer is passed, it is ignored.
GnomeKeyringAttributeList *
gnome_keyring_attribute_list_copy (GnomeKeyringAttributeList *attributes
);
gnome_keyring_attribute_list_copy
is deprecated and should not be used in newly-written code.
Not needed when using libsecret.
Copy a list of item attributes.
const gchar *
gnome_keyring_attribute_get_string (GnomeKeyringAttribute *attribute
);
gnome_keyring_attribute_get_string
is deprecated and should not be used in newly-written code.
Not needed when using libsecret.
Return the string value. It is an error to call this method if
attribute.type
is not GNOME_KEYRING_ATTRIBUTE_TYPE_STRING. This method is
mostly useful for language bindings which do not provide union access. In C
you should just use attribute->value.string.
guint32
gnome_keyring_attribute_get_uint32 (GnomeKeyringAttribute *attribute
);
gnome_keyring_attribute_get_uint32
is deprecated and should not be used in newly-written code.
Not needed when using libsecret.
Return the uint32 value. It is an error to call this method if
attribute.type
is not GNOME_KEYRING_ATTRIBUTE_TYPE_UINT32. This method is
mostly useful for language bindings which do not provide union access. In C
you should just use attribute->value.integer.
GnomeKeyringAttributeType
is deprecated and should not be used in newly-written code.
The data type of the item attribute.
typedef GArray GnomeKeyringAttributeList;
GnomeKeyringAttributeList
is deprecated and should not be used in newly-written code.
typedef struct { char *name; GnomeKeyringAttributeType type; union { char *string; guint32 integer; } value; } GnomeKeyringAttribute;
GnomeKeyringAttribute
is deprecated and should not be used in newly-written code.
libsecret only supports string attributes.
An item attribute. Set string
if data type is
GNOME_KEYRING_ATTRIBUTE_TYPE_STRING
or integer
if data type is
GNOME_KEYRING_ATTRIBUTE_TYPE_UINT32