Starts a synchronous scan.
BiometricScanner objects
Integer scanner.ScanCapture ( timeout, biometricpurpose )
Argument |
Description |
|---|---|
scanner |
The scanner object associated with the device you want to use to complete a scan |
timeout |
Integer value for the period in seconds after which a scan will return |
biometricpurpose |
Enumerated value for the type of scan. Values are:
|
Integer. Returns 1 for success or one of the following negative values if an error occurs:
Error |
Description |
|---|---|
-1 |
General error |
-2 |
Supporting DLL not loaded error |
-3 |
Initialization error other than DLL not loaded |
-4 |
Error in the passed in arguments |
-5 |
Something in the object instance is inconsistent |
-6 |
Call to the driver failed |
-7 |
Error opening the specific scan device |
-8 |
Error in the internal buffer allocation |
-9 |
Incorrect scan state for the requested action |
-10 |
Low level device error |
-11 |
Read is already pending |
-12 |
Read is cancelled |
-13 |
Timeout period expired on the read |
-14 |
Verification error |
-15 |
Signature error |
-16 |
Data handle error |
-17 |
Inconsistent purpose error |
-18 |
Unsupported purpose error |
-19 |
Record not found error |
-20 |
Scan capture error |
-21, -22, -23, -24 |
Internal scanner error |
-25 |
No image available error |
-100 |
Feature not implemented |
Calling ScanCapture starts a synchronous scan operation. The scan returns only when a value has been scanned or the timeout period has expired.
The following scenario scans a fingerprint and compares it to stored data for verification purposes:
Integer l_iret
Integer l_iQuality
Blob l_blbMinutiae, l_blbMinutiaeFromScan
BiometricScanner l_scanner
l_scanner = CREATE HPBiometricScanner
l_iret = l_scanner.Open()
l_iret = l_scanner.ScanCapture(30, & EnrollForVerification!)
sle_quality.text = string(l_scanner.ScannedQuality())
l_iret = l_scanner.ScannedMinutiae(l_blbMinutiae)
l_iret = l_scanner.VerifyMatch(l_blbMinutiaeFromScan, & l_blbMinutiae)
DESTROY l_scanner
