Professional Documents
Culture Documents
DigitalPersona
One Touch for Windows SDK
Version 1.4.0.1
August 2009
-------------------------
How to Use This Document
-------------------------
To view the Readme file on-screen in Windows Notepad, maximize the Notepad window.
On the Format menu, click Word Wrap. To print the Readme file, open it in Notepad
or another word processor, and then use the Print command on the File menu.
---------
CONTENTS
---------
1. INSTALLATION
2. COMPATIBILITY
3. SYSTEM REQUIREMENTS
4. RELEASE NOTES
5. KNOWN ISSUES
6. SUPPORT AND FEEDBACK
----------------
1. INSTALLATION
----------------
You must have local administrator rights to install this product on supported
Windows systems.
-----------------
2. COMPATIBILITY
-----------------
DigitalPersona One Touch for Windows Version 1.4.0.1 is compatible with the
following DigitalPersona products:
Fingerprint templates produced by the One Touch for Windows SDK are also compatible
with the following DigitalPersona SDKs:
- Gold SDK
- Gold CE SDK
- One Touch for Windows SDK, all previous editions
- One Touch for Linux SDK, all distributions
DigitalPersona One Touch for Windows Version 1.4.0.1 is incompatible with any other
DigitalPersona product.
-----------------------
3. SYSTEM REQUIREMENTS
-----------------------
-----------------
4. RELEASE NOTES
-----------------
The SDK sample code can be run through Remote Desktop or a Citrix session.
The following types of Citrix clients are supported for fingerprint authentication:
- Program Neighborhood
- Program Neighborhood Agent
- Web Client
4.2 To deploy your application, you will need to include the DigitalPersona One
Touch for Windows Runtime Environment (RTE) located within the "RTE" folder on the
Product CD. This installs the components required to execute One Touch operations
used by your application. It does not install the sample code and SDK documentation
files.
4.3 In order for Pro Workstation 4.2.0 (and later) or Pro Kiosk 4.2.0 (and later)
to work with an application developed with One Touch for Windows SDK 1.4.0, the
Administrator needs to enable two Group Policy Objects (GPOs):"Use DigitalPersona
Pro Server for authentication" and "Allow Fingerprint Data Redirection". For more
information on how to enable these policies, please see the "DigitalPersona Pro for
AD Guide.pdf" located in the DigitalPersona Pro Server product package.
4.4 This product supports Windows Vista. However, developers may need to modify
application and driver services to run in Windows Vista. Refer to the Microsoft
document: "Impact of Session 0 Isolation on Services and Drivers in Windows Vista"
included in the product package, in the Docs folder as "Session0_Vista.doc".
4.5 If you have JDK or JRE 1.5 or 1.6 installed, and do not have the JAVA_HOME
environment variable defined, the setup program will automatically set the variable
to the JDK or JRE root folder. For example: set JAVA_HOME=c:\Program
Files\Java\jre1.6.0_03.
4.6 Silent installation requires the .NET Framework 2.0 or later. However, you can
run a silent installation without the .NET Framework by modifying the
InstallOnly.bat file to bypass installation of .NET components:
msiexec /i Setup.msi
ADDLOCAL="FpRecLibs,ThinClientRDP,ActiveXFpRecLibs,ActiveXThinClientRDP,JavaFpRecLi
bs,JavaThinClientRDP" /qn /l*v c:\msi.trace.
----------------
5. KNOWN ISSUES
----------------
5.1 You may be required to manually locate the usbdpfp.sys file (fingerprint reader
driver) when installing this product on an XP Embedded computer. The file is
located in the "\Windows\DPDrv" folder.
5.2 You may encounter the message "component comdlg32.ocx or one of its
dependencies not correctly registered" when running the Enrollment.exe sample code
for COM/ActiveX on some systems. For 32-bit operating systems, locate the
comdlg32.ocx file and place it in the Windows\system32 folder. For 64-bit operating
systems, place it in the Windows\sysWOW64 folder then manually register this
component. For systems running Visual Basic 6, this file will already be installed.
5.3 The Java Console sample application will not run if you have Digitalpersona Pro
Workstation or Kiosk installed on the computer.
5.4 When creating your own msi installer for 64-bit application using the merge
modules, you need to specify separate target directories for 32-bit and 64-bit
merge modules.
------------------------
6. SUPPORT AND FEEDBACK
------------------------