GnomeKeyringFound

typedef struct {
	char *keyring;
	guint item_id;
	GnomeKeyringAttributeList *attributes;
	char *secret;
} GnomeKeyringFound;

A found structure returned by a found operation. Use gnome_keyring_found_list_free() to free a list of these structures.

gnome_keyring_found_copy ()

GnomeKeyringFound * gnome_keyring_found_copy            (GnomeKeyringFound *found);

Copy a GnomeKeyringFound item.

gnome_keyring_found_free ()

void                gnome_keyring_found_free            (GnomeKeyringFound *found);

Free the memory used by a GnomeKeyringFound item.

You usually want to use gnome_keyring_found_list_free() on the list of results.

gnome_keyring_found_list_free ()

void                gnome_keyring_found_list_free       (GList *found_list);

Free the memory used by the GnomeKeyringFound items in found_list.

gnome_keyring_find_items ()

gpointer            gnome_keyring_find_items            (GnomeKeyringItemType type,
                                                         GnomeKeyringAttributeList *attributes,
                                                         GnomeKeyringOperationGetListCallback callback,
                                                         gpointer data,
                                                         GDestroyNotify destroy_data);

Searches through all keyrings for items that match the attributes. The matches are for exact equality.

A GList of GnomeKeyringFound structures are passed to the callback. The list and structures are freed after the callback returns.

The user may have been prompted to unlock necessary keyrings, and user will have been prompted for access to the items if needed.

For a synchronous version of this function see gnome_keyring_find_items_sync().

gnome_keyring_find_itemsv ()

gpointer            gnome_keyring_find_itemsv           (GnomeKeyringItemType type,
                                                         GnomeKeyringOperationGetListCallback callback,
                                                         gpointer data,
                                                         GDestroyNotify destroy_data,
                                                         ...);

Searches through all keyrings for items that match the specified attributes. The matches are for exact equality.

The variable argument list should contain a) The attribute name as a null terminated string, followed by b) The attribute type, either GNOME_KEYRING_ATTRIBUTE_TYPE_STRING or GNOME_KEYRING_ATTRIBUTE_TYPE_UINT32 and then the c) attribute value, either a character string, or 32-bit unsigned int. The list should be terminated with a NULL.

A GList of GnomeKeyringFound structures are passed to the callback. The list and structures are freed after the callback returns.

The user may have been prompted to unlock necessary keyrings, and user will have been prompted for access to the items if needed.

For a synchronous version of this function see gnome_keyring_find_itemsv_sync().

gnome_keyring_find_items_sync ()

GnomeKeyringResult  gnome_keyring_find_items_sync       (GnomeKeyringItemType type,
                                                         GnomeKeyringAttributeList *attributes,
                                                         GList **found);

Searches through all keyrings for items that match the attributes and type. The matches are for exact equality.

A GList of GnomeKeyringFound structures is returned in found. The list may have zero items if nothing matched the criteria. The list should be freed using gnome_keyring_found_list_free().

The user may have been prompted to unlock necessary keyrings, and user will have been prompted for access to the items if needed.

For an asynchronous version of this function see gnome_keyring_find_items().

gnome_keyring_find_itemsv_sync ()

GnomeKeyringResult  gnome_keyring_find_itemsv_sync      (GnomeKeyringItemType type,
                                                         GList **found,
                                                         ...);

Searches through all keyrings for items that match the attributes and type. The matches are for exact equality.

The variable argument list should contain a) The attribute name as a null terminated string, followed by b) The attribute type, either GNOME_KEYRING_ATTRIBUTE_TYPE_STRING or GNOME_KEYRING_ATTRIBUTE_TYPE_UINT32 and then the c) attribute value, either a character string, or 32-bit unsigned int. The list should be terminated with a NULL.

A GList of GnomeKeyringFound structures is returned in found. The list may have zero items if nothing matched the criteria. The list should be freed using gnome_keyring_found_list_free().

The user may have been prompted to unlock necessary keyrings, and user will have been prompted for access to the items if needed.

For an asynchronous version of this function see gnome_keyring_find_items().