Document Title Here
AET65 API
Version 1.0
idvation GmbH
Otto-Hesse-Straße 19 / T5
Phone +49 6151 9926567
D-64293 Darmstadt
Fax +49 6151 3689296
www.idvation.com
Page 16 of 84
Page 16 of 84
3.3.2.
ABSVerify
ABS_STATUS ABSVerify(
IN ABS_CONNECTION hConnection
IN ABS_OPERATION *pOperation
IN ABS_DWORD dwTemplateCount
IN ABS_BIR **pTemplateArray
OUT ABS_LONG *pResult
IN ABS_DWORD dwFlags
)
Description
This function captures sample from the FM, processes it into
template and compares it with templates, specified by the
pTemplateArray parameter and finds out the first template which
matches the swiped finger.
Parameters
hConnection
Handle to the connection to FM.
pOperation
See description of ABS_OPERATION.
dwTemplateCount
Count of templates in the pTemplateArray.
pTemplateArray
Pointer to the array of pointers to templates.
pResult
Pointer to memory location, where result of the comparing will be
stored. The result is indexed into the pTemplateArray, determining
the matching template, or -1 if no template matches.
dwFlags
Bitmask specifying flags, which modify slightly behavior of the
function.
This function supports flags ABS_FLAG_NOTIFICATION and
ABS_FLAG_AUTOREPEAT.
If ABS_FLAG_NOTIFICATION is set, the verification operation
does not show any GUI feedback until the finger is swiped. This
can be useful for applications doing their own work; and only when
user swipes, the application processes some special action. Until
the user swipes, he is not disrupted with any dialog.
Showing/hiding of the dialog is controlled by messages
ABS_MSG_DLG_SHOW and ABS_MSG_DLG_HIDE.
If flag ABS_FLAG_AUTOREPEAT is used, the verification is
automatically restarted when the user's swipe does not match any
template in pTemplateArray. This is better than calling the function
in a loop until the user's swipe matches some template in the
pTemplateArray, because this can prevent a GUI feedback dialog
from hiding and showing between the calls.
Return Value
ABS_STATUS
Result code. ABS_STATUS_OK (0) means
success.