AuthAttemptResult Event
Reports the outcome of an authentication attempt.
Syntax
ANSI (Cross Platform) virtual int FireAuthAttemptResult(AuthenticatorAuthAttemptResultEventParams *e);
typedef struct {
const char *UserID;
const char *AuthMethod;
int AuthRes;
char *RemainingAuthMethods; int reserved; } AuthenticatorAuthAttemptResultEventParams; Unicode (Windows) virtual INT FireAuthAttemptResult(AuthenticatorAuthAttemptResultEventParams *e);
typedef struct {
LPCWSTR UserID;
LPCWSTR AuthMethod;
INT AuthRes;
LPWSTR RemainingAuthMethods; INT reserved; } AuthenticatorAuthAttemptResultEventParams;
- (void)onAuthAttemptResult:(NSString*)userID :(NSString*)authMethod :(int*)authRes :(NSString**)remainingAuthMethods;
#define EID_AUTHENTICATOR_AUTHATTEMPTRESULT 1 virtual INT SECUREBLACKBOX_CALL FireAuthAttemptResult(LPSTR &lpszUserID, LPSTR &lpszAuthMethod, INT &iAuthRes, LPSTR &lpszRemainingAuthMethods);
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.