authenticate

This signal is emitted when an item needs to be unlocked or decrypted before it can be parsed.

The count argument specifies the number of times the signal has been emitted for a given item. This can be used to display a message saying the previous password was incorrect.

Typically the add_password function is called in response to this signal.

If false is returned, then the authentication was not handled. If no handlers return true then the item is not parsed and an error with the code gcr_error_cancelled will be raised.

Parameters:

count

the number of times this item has been authenticated

Returns:

Whether the authentication was handled.