PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
CheckUserIdentity (Function)
In French: VérifieIdentitéUtilisateur
Allows you to check the real identity of current user via biometrics check.
If the authentication is available, a message asks the user to authenticate himself. Then, the WLanguage authentication procedure is called.
iPhone/iPad Note: This function is using the "Touch ID" feature of iPhones 5S and later versions. This function is available from iOS version 8.0. The project must be compiled with Xcode 6.
Notes:
  • iPhone/iPad This function is available from iOS version 8.0. The project must be compiled with Xcode 6 (or later). This function is using:
    • the "Touch ID" feature of iPhones 5S and later versions.
    • Versions 23 and later
      the "Facial recongnition" feature of iPhone X.
      New in version 23
      the "Facial recongnition" feature of iPhone X.
      the "Facial recongnition" feature of iPhone X.
  • Versions 23 and later
    Android This feature is available from Android 6.0 (api level 23).
    New in version 23
    Android This feature is available from Android 6.0 (api level 23).
    Android This feature is available from Android 6.0 (api level 23).
Versions 23 and later
Android This function is now available for the Android applications.
New in version 23
Android This function is now available for the Android applications.
Android This function is now available for the Android applications.
Example
CheckUserIdentity("Check the identity for unlocking", Authentication)
// Check procedure
PROCÉDURE Authentication(nStatus is int, sErrorMessage is string)

SWITCH nStatus
CASE cuiAuthenticated
Info("Authentication OK")
CASE cuiAuthenticationFailure
Error("Authentication failure: " + sErrorMessage)
CASE cuiAuthenticationUnavailable
Error("Authentication not available")
CASE cuiCustomAuthentication
pwd is string
// Comments typed by the user in a multiline control
SWITCH Input("Enter the password: ", pwd)
// OK
CASE 1:
// Cancel
CASE 0:
END
END
Syntax
CheckUserIdentity(<Message> , <Procedure Name> [, <Button Caption>])
<Message>: Character string (with quotes)
Message that will be displayed to the user.
iPhone/iPad
  • If this string is a multiline string, only the first line will be visible in the identification popup.
  • This parameter is ignored during a facial recognition.
<Procedure Name>: Character string (with or without quotes)
Name of WLanguage procedure ("callback") called at the end of user authentication. This procedure has the following format:
PROCEDURE <Procedure Name> (<Status>, <Error Message>)
where:
  • <Status> is an Integer constant indicating the authentication status:
    cuiAuthenticationUnavailableThe authentication feature is not available or it was disabled by the user.
    cuiCustomAuthenticationThe user wants to authenticate by using a password: the application will have to manage this authentication manually
    cuiAuthenticatedThe user was properly authenticated.
    cuiAuthenticationFailureThe authentication failed.
  • <Error Message> is a character string containing the system error message in case of authentication failure (cuiAuthenticationFailure constant). Otherwise, this parameter corresponds to an empty string.
<Button Caption>: Optional character string (with quotes)
Default caption of authentication button (displayed on the button for typing the password). This button is used to connect without checking the biometrics. This button is displayed as soon as the first failure occurs.
Components
Android wd230android.jar
Minimum required version
  • Version 20
Comments
Click [Add] to post a comment