Gcr.Parser::authenticate

connect('authenticate', function (parser, count: Number(gint), ): Boolean);
  

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 Gcr.Parser.prototype.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.DataError.cancelled will be raised.