AuthAttemptResult Event
Reports the outcome of an authentication attempt.
Syntax
class AuthenticatorAuthAttemptResultEventParams { public: const QString &UserID(); const QString &AuthMethod(); int AuthRes(); void SetAuthRes(int iAuthRes); const QString &RemainingAuthMethods(); void SetRemainingAuthMethods(const QString &qsRemainingAuthMethods); int EventRetVal(); void SetEventRetVal(int iRetVal); };
// To handle, connect one or more slots to this signal. void AuthAttemptResult(AuthenticatorAuthAttemptResultEventParams *e);
// Or, subclass Authenticator and override this emitter function. virtual int FireAuthAttemptResult(AuthenticatorAuthAttemptResultEventParams *e) {...}
Remarks
This event follows a call to ContinueAuth method and reports the user's updated authentication status following the token verification.
The updated status is reported via the AuthRes parameter, and can take one of the following values:
arAuthFurtherAuthNeeded | 0 |
arAuthSucceeded | 1 |
arAuthFailed | 2 |
The RemainingAuthMethods parameter lists the authentication methods that the user is yet to go through. The application can change either of AuthRes and RemainingAuthMethods in the event handler to alter the authentication flow.