This topic provides guidelines for installing a fingerprint management application (FMA) on Windows 7, and for FMA registration.
This information applies to the following operating systems:
- Windows Server 2008 R2
- Windows 7
Pre-installation
The installation program for an FMA must ensure that the prerequisite software is present before it installs the FMA.
The WBF and .NET are not installed by default on Windows Server 2008 R2. If an FMA detects a server operating system during installation, it should check whether the WBF and .NET components are present. If they are not present, the FMA should direct the user to install these components. For more information on the WBF and .NET, see Related topics in Designing Windows Biometric Framework Fingerprint Management Applications.
To check whether your FMA is running on a server SKU, check the operating system type by using these steps:
- Call Win32::GetVersionEx(). This function fills in an OSVERSIONINFOEX structure.
- Use the values in the OSVERSIONINFOEX structure to determine the operating system type.
- If the dwProductType does not equal VER_NT_WORKSTATION, then your FMA is running on a server operating system.
The following table shows the fields of the OSVERSIONINFOEX structure for the client and server editions of Windows 7 and Windows Server 2008 R2.
Values in the OSVERSIONINFOEX Structure
| Operating system | Operating system version | dwMajorVersion | dwMinorVersion | dwProductType |
|---|---|---|---|---|
| Windows 7 client | 6.1 | >=6 | >=1 | == VER_NT_WORKSTATION |
| Windows Server 2008 R2 | 6.1 | >=6 | >=1 | != VER_NT_WORKSTATION |
FMA registration
You can associate your FMA with a specific biometric device, with a subset of devices, or with all of the biometric devices on the system. An FMA that is associated with all of the biometric devices on the system is called a global FMA.
An FMA that is associated with a specific device or set of devices is called a device-specific FMA.
Register a global FMA
To register an FMA as a global FMA, set the following registry location:
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Control Panel\WinBio\FMA]
@=""
"CommandLine"="%ProgramFiles%\\FMA\\fma.exe %{biounitid}"
This location stores the command line and the replacement specification for an FMA that will be used for all biometric units.
CommandLine – this value contains the string used to run the FMA. In the example above, the FMA is invoked by %ProgramFiles%\FMA\fma.exe.
Register a device-specific FMA
To register an FMA for a single device, set the following registry location:
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Control Panel\WinBio\FMA\<WINBIO_UNIT_SCHEMA::Manufacturer>\<WINBIO_UNIT_SCHEMA::Model>]
@=""
"CommandLine"="%ProgramFiles%\\FMA\\fma.exe %{biounitid}"
This location stores the command line and the replacement specification for an FMA that will be used for a specific biometric unit.
CommandLine – this value contains the string used to run the FMA. In the example above, the FMA is invoked by %ProgramFiles%\FMA\fma.exe.
To register your FMA for more than one biometric device, set the registry key shown above for each device.
Post-installation
After you successfully install your FMA, we recommend that you display a finish page with a message that guides the user through the next steps, such as enrollment or Windows logon.
Note The FMA should not reboot the system when it is installing or uninstalling new drivers or applications. The FMA installer should not reboot the system.
Related topics
Designing Windows Biometric Framework Fingerprint Management Applications