authenticate


Description:

public signal bool authenticate (Auth auth, bool retrying)

Emitted when the message requires authentication.

If credentials are available call [method@Auth.authenticate] on auth. If these credentials fail, the signal will be emitted again, with retrying set to true, which will continue until you return without calling [ method@Auth.authenticate] on auth.

Note that this may be emitted before msg's body has been fully read.

You can authenticate auth asynchronously by calling [method@GObject.Object.ref] on auth and returning true. The operation will complete once either [method@Auth.authenticate] or [method@Auth.cancel] are called.

Parameters:

auth

the Auth to authenticate

retrying

true if this is the second (or later) attempt

Returns:

true to stop other handlers from being invoked or false to propagate the event further.