One Touch For Windows SDK .NET Developer Guide

Machine Translated by Google
DigitalPersona, Inc.
SDK de One Touch® para Windows®
Edición .NET
Versión 1.6
Guía del desarrollador
DigitalPersona, Inc. ©
1996–2010 DigitalPersona, Inc. Todos los derechos reservados.
Todos los derechos de propiedad intelectual del software, el firmware, el hardware y la documentación de DigitalPersona incluidos o descritos en esta
guía son propiedad de DigitalPersona o sus proveedores y están protegidos por las leyes de derechos de autor de los Estados Unidos, otras leyes
de derechos de autor aplicables y las disposiciones de tratados internacionales. DigitalPersona y sus proveedores conservan todos los derechos no
otorgados expresamente.
DigitalPersona, U.are.U y One Touch son marcas comerciales de DigitalPersona, Inc., registradas en los Estados Unidos y otros
países. Adobe y Adobe Reader son marcas registradas o marcas comerciales de Adobe Systems Incorporated en los Estados Unidos y/
o en otros países. Microsoft, Visual C++, Visual Studio, Windows, Windows Server y Windows Vista son marcas comerciales registradas
de Microsoft Corporation en los Estados Unidos y otros países.
Esta guía y el software que describe se proporcionan bajo licencia según se establece en el "Acuerdo de licencia" que se muestra
durante el proceso de instalación.
Salvo que lo permita dicha licencia o los términos de esta guía, ninguna parte de este documento puede reproducirse, almacenarse,
transmitirse ni traducirse, de ninguna forma y por ningún medio, sin el consentimiento previo por escrito de DigitalPersona. El
contenido de esta guía se proporciona únicamente con fines informativos y está sujeto a cambios sin previo aviso. Cualquier mención
de empresas y productos de terceros es solo para fines de demostración y no constituye un respaldo ni una recomendación.
DigitalPersona no asume ninguna responsabilidad con respecto al rendimiento o uso de estos productos de terceros. DigitalPersona
hace todo lo posible para garantizar la precisión de su documentación y no asume ninguna responsabilidad por los errores o inexactitudes
que puedan aparecer en ella.
Apoyo técnico
Tras la compra de un paquete de soporte para desarrolladores (disponible en http://buy.digitalpersona.com), tiene derecho a una cantidad
específica de horas de soporte telefónico y por correo electrónico.
Comentario
Aunque la información de esta guía ha sido revisada y probada minuciosamente, agradecemos sus comentarios sobre cualquier
error, omisión o sugerencia para futuras mejoras. Por favor contáctenos en
TechPubs@digitalpersona.com
o
DigitalPersona, Inc.
720 Bay Road, Suite 100
Redwood City, California 94063
EE.
UU. (650)
4744000 (650) 2988313 Fax
Fecha de publicación del documento: 22 de junio de 2010 (1.6.0)
Tabla de contenido
1. Introducción . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Público objetivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Descripción general del capítulo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Convenciones del documento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Convenciones Notacionales. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Convenciones tipográficas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Convenciones de
nomenclatura . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Recursos adicionales . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Documentación relacionada. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Recursos en línea . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Requisitos del sistema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Productos de hardware de DigitalPersona admitidos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Compatibilidad
con plantillas de huellas dactilares. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2 Inicio rápido. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
conceptos rápidos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6 Instale el software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Conecte el lector de huellas dactilares. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Uso de la aplicación de muestra. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3 Instalación. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Instalación del SDK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Instalación del
entorno de tiempo de ejecución (RTE) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Instalación y desinstalación del RTE Silently. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
4 Resumen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Sistema biométrico. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 Huella
dactilar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 Reconocimiento de
huellas dactilares. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Registro de huellas
dactilares . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Verificación de huellas
dactilares. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Falsos positivos y falsos
negativos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 Flujos de
trabajo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Flujo de trabajo de registro de huellas dactilares. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Inscripción de huellas dactilares con soporte de interfaz de usuario. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25 Registro de una huella digital . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Anulación de la inscripción (eliminación) de una plantilla de huellas dactilares . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
27
Verificación de huellas dactilares. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
DigitalPersona One Touch para Windows SDK: Edición .NET | Guía del desarrollador iii
Tabla de contenido
Verificación de huellas dactilares con soporte de interfaz de usuario. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
32 Serialización/deserialización de objetos de datos de huellas dactilares . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Serialización de un objeto de datos de huellas dactilares . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Deserializar un objeto de datos de huellas dactilares serializados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
5 Referencia de la API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
excepciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Componentes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Componente
compartido. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 DPFP. Clase de
datos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Constructores predeterminados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Datos() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Datos
(Flujo) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Métodos
públicos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Serializar(ref byte[]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Deserializar
(byte[]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Serializar
(Stream) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Deserializar
(Transmisión) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 Propiedades
Públicas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
bytes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
tamaño. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Clase DPFP.FeatureSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Constructores Públicos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Conjunto de características() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Conjunto de funciones (flujo) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
DPFP. Clase de muestra. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Muestra() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Muestra (Flujo) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
DPFP.Clase de plantilla. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Constructores
Públicos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Plantilla() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Plantilla
(Flujo) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Clase
DPFP.Error.SDKException . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Propiedad
Pública . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Código de
error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Enumeración pública. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Códigos de error. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Biblioteca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Componente
de captura. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
DigitalPersona One Touch para Windows SDK: Edición .NET | Guía del desarrollador IV
Tabla de contenido
DPFP.Capture.Clase de captura . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Constructores Públicos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Capturar (Cadena, Prioridad) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Capturar(Cadena) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Captura (Prioridad) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Captura() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 Métodos
públicos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Iniciar captura() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
DetenerCaptura() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Propiedades Públicas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Prioridad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Número de serie del lector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Controlador de eventos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
DPFP.Capture.ReaderDescription Clase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 Constructores
Públicos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Descripción del lector (Guid) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Descripción del lector (cadena) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Revisión de firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Revisión de hardware. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Idioma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 Tipo de
impresión . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 Nombre del
producto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Número de serie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Tipo de número de serie. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Tecnología . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Proveedor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Enumeraciones Públicas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
ReaderImpressionType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 Tecnología
del lector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 Tipo de número de
serie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 Clase
DPFP.Capture.ReadersCollection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 Constructor
Público . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Colección de Lectores() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Método público . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Actualizar() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Indexadores públicos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
ReaderDescription este[Guid] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
ReaderDescription this[int] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
ReaderDescription esta[cadena] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
DigitalPersona One Touch para Windows SDK: Edición .NET | Guía del desarrollador en
Tabla de contenido
Clase DPFP.Capture.ReaderVersion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 Constructor
Público . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
ReaderVersion(uint, uint, uint) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 Método
público . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Encadenar() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 Propiedades
Públicas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Construir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Importante . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
menor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Clase DPFP.Capture.SampleConversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Constructor
Público . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Conversión de muestra() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Métodos
públicos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
ConvertToANSI381(Muestra, byte de referencia[]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
ConvertToPicture(Muestra, mapa de bits de referencia) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
DPFP.Capture.CaptureFeedback Enumeración . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Miembros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Comentarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
DPFP.Captura.Enumeración de prioridad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Miembros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . sesenta y cinco
Comentarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . sesenta y cinco
Interfaz DPFP.Capture.EventHandler. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 Eventos
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . sesenta y cinco
OnComplete(Objeto, Cadena, Muestra) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
OnFingerGone(Objeto, Cadena) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
OnFingerTouch(Objeto, Cadena) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
OnReaderConnect(Objeto, Cadena) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
OnReaderDisconnect(Objeto, Cadena) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
OnSampleQuality(Object, String, CaptureFeedback) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Bibliotecas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Componente de interfaz gráfica de usuario. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
69 Enumeración pública . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Estado del controlador de eventos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Biblioteca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 Espacio de
nombres de inscripción . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
DPFP.Gui.Enrollment.Clase de control de inscripción . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Constructor Público. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
DigitalPersona One Touch para Windows SDK: Edición .NET | Guía del desarrollador nosotros
Tabla de contenido
Control de Inscripción() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Máscara de dedo registrada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
MaxEnrollFingerCount. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
ReaderSerialNumber. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Interfaz DPFP.Gui.Enrollment.EventHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 Eventos
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
OnCancelEnroll(Objeto, Cadena, int) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
OnComplete(Objeto, Cadena, int) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
OnDelete(Object, int, ref Gui.EventHandlerStatus) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 OnEnroll(Object,
int, Template, ref Gui.EventHandlerStatus) . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 OnFingerRemove(Objeto, Cadena,
int) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 OnFingerTouch(Objeto, Cadena,
int) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 OnReaderConnect(Objeto, Cadena,
int) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
OnReaderDisconnect(Objeto, Cadena, int) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
OnSampleQuality(Object, String, int, Capture.CaptureFeedback) . . . . . . . . . . . . . . . . . . . . . . . 78 OnStartEnroll(Objeto,
Cadena, int) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Biblioteca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Espacio de nombres de verificación . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
DPFP.Gui.Verification.VerificationControl Clase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
VerificaciónControl() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Activo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
ReaderSerialNumber. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Interfaz DPFP.Gui.Verification.EventHandler. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 Evento
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
OnComplete(Object, FeatureSet, ref Gui.EventHandlerStatus) . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Biblioteca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Componente de procesamiento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
DPFP.Processing.FeatureExtraction Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 Constructor
Público . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Extracción de características() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
83 Método público . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
CreateFeatureSet(Sample, DataPurpose, ref CaptureFeedback, ref FeatureSet) . . . . . . . . . . 83
Clase.de.inscripción.de.procesamiento.de.DPFP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
DigitalPersona One Touch para Windows SDK: Edición .NET | Guía del desarrollador viii
Tabla de contenido
Inscripción() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Métodos públicos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
AddFeatures(Conjunto de características) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
85 Limpiar() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Funciones necesarias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Plantilla . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 Estado
de la plantilla . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Enumeración pública. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Estado . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
DPFP.Processing.DataPurpose Enumeration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Miembros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Comentarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
bibliotecas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Componente de verificación. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
DPFP.Verification.Verification Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Verificación() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Verificación (int) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Método . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Verificar (Conjunto de funciones, Plantilla, Resultado de referencia) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
91 Propiedades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
FAR Solicitado . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
DPFP.Verification.Result Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Constructor predeterminado . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Propiedades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
FARAlogrado . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Verificado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Biblioteca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
6 Interfaces gráficas de usuario. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 Interfaz gráfica de
usuario de DPFP.Gui.Enrollment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 Registro de una huella
digital . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 Anulación del registro
(eliminación) de una huella digital . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 Interfaz
gráfica de usuario de DPFP.Gui.Verification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
DigitalPersona One Touch para Windows SDK: Edición .NET | Guía del desarrollador viii
Tabla de contenido
7 Desarrollo de aplicaciones compatibles con Citrix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
8 Redistribución . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
RTE\Carpeta de instalación. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Carpeta Redist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Documentación del lector de huellas dactilares. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Advertencias de hardware e información reglamentaria. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 Guía de
uso y mantenimiento del lector de huellas dactilares . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
A Configuración de la tasa de aceptación falsa. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Tasa de aceptación falsa (FAR) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Representación de la Probabilidad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Solicitud de FAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Especificación de FAR en C# . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Especificación de FAR en Visual Basic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
alcanzado LEJOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Prueba . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
B Conversión de plantilla de inscripción Platinum SDK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Conversión de plantilla de inscripción Platinum SDK para Microsoft Visual C++ Conversión . . . . . . . . . . . . . . . . . . . . . . . . . . 114
de plantilla de inscripción Platinum SDK para Visual Basic 6.0. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
glosario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
índice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
DigitalPersona One Touch para Windows SDK: Edición .NET | Guía del desarrollador ix
Introducción 1
One Touch® para Windows SDK es una herramienta de desarrollo de software que permite a los desarrolladores integrar
biometría de huellas dactilares en un amplio conjunto de aplicaciones, servicios y productos basados en Microsoft® Windows®. La
herramienta permite a los desarrolladores realizar operaciones biométricas básicas de huellas dactilares: capturar una huella
dactilar de un lector de huellas dactilares DigitalPersona, extraer las características distintivas de la muestra de huellas dactilares
capturadas y almacenar los datos resultantes en una plantilla para comparar posteriormente una huella dactilar enviada con
una plantilla de huellas dactilares existente. .
Además, el SDK de One Touch para Windows permite a los desarrolladores utilizar una variedad de lenguajes de programación en
varios entornos de desarrollo para crear sus aplicaciones. El producto incluye documentación detallada y un código de
muestra que se puede usar para guiar a los desarrolladores a producir rápida y eficientemente adiciones biométricas de huellas
dactilares a sus productos.
One Touch para Windows SDK se basa en un legado de una década de tecnología biométrica de huellas dactilares, siendo el conjunto
de herramientas de desarrollo más popular con el conjunto más grande de usuarios inscritos de cualquier producto biométrico en el
mundo. Debido a su popularidad, el software DigitalPersona® Fingerprint Recognition Engine, con su alto nivel de precisión, y el
galardonado hardware U.are.U® Fingerprint Reader se han utilizado con el grupo demográfico de usuarios más antiguo y más difícil
de tomar huellas dactilares en el mundo.
El SDK de One Touch para Windows ha sido diseñado para autenticar usuarios en los sistemas operativos Microsoft® Windows
Vista® y Microsoft® Windows® XP que se ejecutan en cualquiera de las plataformas basadas en x86. El producto se utiliza con
lectores de huellas dactilares DigitalPersona en una variedad de configuraciones útiles: periféricos USB independientes, módulos
integrados en plataformas de clientes y teclados.
También tenga en cuenta que DigitalPersona One Touch ID SDK incluye One Touch para Windows RTE, documentación
de .NET y muestras de .NET también; y se puede utilizar para implementar un producto biométrico completo que abarque la
recopilación, el registro y la verificación de huellas dactilares. Recomendamos encarecidamente que los desarrolladores de OTID
utilicen esta versión integrada de OTW.
Autenticación de huellas digitales en una computadora remota
Este SDK incluye soporte transparente para la autenticación de huellas dactilares a través de Windows Terminal Services
(incluida la conexión a escritorio remoto) ya través de una conexión de Citrix a Metaframe Presentation Server utilizando un cliente
del paquete Citrix Presentation Server Client.
A través de Escritorio remoto o una sesión de Citrix, puede usar un lector de huellas dactilares local para iniciar sesión y usar otras
funciones instaladas en una máquina remota que ejecuta su aplicación habilitada para huellas dactilares.
Se admiten los siguientes tipos de clientes Citrix:
Programa Vecindario
Agente del Programa Vecindario
cliente web
DigitalPersona One Touch para Windows SDK: Edición .NET | Guía del desarrollador 1
Capítulo 1: Introducción Público objetivo
Para aprovechar esta característica, su aplicación habilitada para huellas dactilares debe ejecutarse en el servidor de Terminal
Services o Citrix, no en el cliente. Consulte también Desarrollo de aplicaciones compatibles con Citrix a partir de la página 104.
Público objetivo
Esta guía es para desarrolladores que tienen un conocimiento práctico del lenguaje de programación C# o Microsoft® Visual
Basic® 2005 y el entorno de desarrollo Microsoft® Visual Studio® 2005 (o posterior).
Descripción general del capítulo
El Capítulo 1, Introducción (este capítulo), describe la audiencia para la que está escrita esta guía; define las convenciones
tipográficas, de notación y de nomenclatura utilizadas en esta guía; cita una serie de recursos que pueden ayudarlo a usar One
Touch para Windows SDK: .NET Edition; identifica los requisitos mínimos del sistema necesarios para ejecutar One Touch para
Windows SDK: .NET Edition; y enumera los productos DigitalPersona y las plantillas de huellas dactilares compatibles con
One Touch para Windows SDK: .NET Edition.
El Capítulo 2, Inicio rápido, proporciona una introducción rápida a One Touch para Windows SDK: .NET Edition utilizando una de las
aplicaciones de muestra proporcionadas como parte del SDK.
El Capítulo 3, Instalación, contiene instrucciones para instalar los diversos componentes del producto e identifica los archivos y carpetas
que están instalados en su disco duro.
El Capítulo 4, Descripción general, presenta la terminología y los conceptos de One Touch para Windows SDK: .NET Edition.
Este capítulo también incluye diagramas de flujo de trabajo típicos y explicaciones de los componentes de One Touch para
Windows: .NET Edition API utilizados para realizar las tareas en los flujos de trabajo.
El Capítulo 5, Referencia de API, define los componentes que se utilizan para desarrollar aplicaciones basadas en One Touch para
Windows: API de .NET Edition.
El Capítulo 6, Interfaces gráficas de usuario, describe la funcionalidad de las interfaces gráficas de usuario incluidas con los objetos
DPFP.Gui.Enrollment.EnrollmentControl y DPFP.Gui.Verification.VerificationControl.
El Capítulo 8, Redistribución, identifica los archivos que puede distribuir de acuerdo con el Acuerdo de licencia de usuario
final (EULA) y enumera las funcionalidades que necesita proporcionar a sus usuarios finales cuando desarrolla productos basados
en One Touch para Windows: .NET Edition API.
El Apéndice A, Configuración de la tasa de aceptación falsa, brinda información sobre cómo determinar y usar valores específicos para
la FAR y cómo evaluar y probar los valores logrados.
El Apéndice B, Conversión de plantillas de registro de Platinum SDK, contiene código de muestra para convertir plantillas de registro
de Platinum SDK para usar con One Touch para Windows SDK: .NET Edition.
También se incluyen un glosario y un índice para su referencia.
Capítulo 1: Introducción Convenciones de documentos
Convenciones de documentos
Esta sección define las convenciones de nomenclatura, tipográficas y de nomenclatura utilizadas en esta guía.
Convenciones de notación
En esta guía se utilizan las siguientes convenciones de notación:
NOTA: Las notas proporcionan recordatorios, consejos o sugerencias adicionales.
IMPORTANTE: Las anotaciones importantes contienen información significativa sobre el comportamiento del sistema, incluidos problemas o
efectos secundarios que pueden ocurrir en situaciones específicas.
Convenciones tipográficas
En esta guía se utilizan las siguientes convenciones tipográficas:
tipografía Objetivo Ejemplo
Atrevido Se utiliza para pulsaciones de teclas y elementos de ventanas Haga clic en Registro de huellas dactilares.

y cuadros de diálogo y para indicar tipos de datos
Aparecerá el cuadro de diálogo Registro de huellas dactilares .
Cadena que contiene un número de serie del lector de huellas
dactilares
mensajero Se usa para indicar el código de programación de la computadora Verifique la propiedad TemplateStatus después de cada llamada al método
atrevido AddFeatures .
Inicialice una nueva instancia de DPFP.Capture.
Clase de captura .
Cursiva Se usa para enfatizar o para introducir nuevos términos. Esta sección incluye ilustraciones de flujos de trabajo típicos de registro de

huellas dactilares y verificación de huellas dactilares. (énfasis)
Si está viendo este documento en línea, al hacer clic en
el texto en cursiva también se puede activar un enlace
de hipertexto a otras áreas de esta guía o URL. Una huella dactilar es una impresión de las crestas en la piel de un dedo.
(nuevo término)
Consulte Instalación del SDK en la página 8. (enlace al encabezado y la
página)
Convenciones de nombres
DPFP significa DigitalPersona Fingerprint.
Capítulo 1: Introducción Recursos adicionales
Recursos adicionales
Puede consultar los recursos en esta sección para ayudarlo a usar One Touch para Windows SDK: .NET Edition.
Documentación relacionada
Sujeto Documento
Reconocimiento de huellas dactilares, incluida la historia y los conceptos Libro blanco de DigitalPersona: Guía para el reconocimiento de huellas
básicos de la identificación de huellas dactilares y las ventajas de dactilares.
Motor de reconocimiento de huellas dactilares de DigitalPersona
El archivo, Fingerprint Guide.pdf, se encuentra en la carpeta Docs del
paquete de software One Touch para Windows y no se instala
automáticamente en su computadora como parte del proceso de
configuración.
Últimas noticias sobre el producto Los archivos Readme.txt proporcionados en el directorio raíz del paquete de
software SDK, así como en algunos subdirectorios
Recursos en línea
Nombre del Sitio Web URL
Foro de conexión de desarrolladores de DigitalPersona para la interacción http://www.digitalpersona.com/webforums/
entre pares entre desarrolladores de DigitalPersona
Últimas actualizaciones para productos de software DigitalPersona http://www.digitalpersona.com/support/downloads/software.php _
Requisitos del sistema
Esta sección enumera los requisitos mínimos de software y hardware necesarios para ejecutar One Touch para Windows SDK: .NET
Edition.
Procesador basado en x86 o superior
Microsoft® Windows® XP, versiones de 32 y 64 bits; Microsoft® Windows® XP Embedded, versión de 32 bits1; o Microsoft®
Windows Vista®, versiones de 32 y 64 bits
Microsoft .NET Framework (versión 2 y posterior), que se requiere para ejecutar proyectos .NET y se puede obtener
de Microsoft
Conector USB en el ordenador donde se va a conectar el lector de huellas dactilares
1. Se incluye una lista de dependencias de DLL para la instalación de su aplicación en Microsoft Windows XP Embedded, One Touch para Windows XPE Dependencies.xls.
ubicado en la carpeta Docs en el paquete de software SDK.
Capítulo 1: Introducción Productos de hardware DigitalPersona compatibles
Productos de hardware DigitalPersona compatibles
One Touch para Windows SDK: .NET Edition es compatible con los siguientes productos de hardware de DigitalPersona:
Módulos y lectores de huella digital DigitalPersona U.are.U 4000B/4500 o posterior
Teclado de huella digital DigitalPersona U.are.U
Compatibilidad con plantillas de huellas dactilares
Las plantillas de huellas dactilares producidas por todas las ediciones de One Touch para Windows SDK también son compatibles con los siguientes
SDK de DigitalPersona:
SDK de oro
SDK CE dorado
One Touch para Linux SDK, todas las distribuciones
NOTA: Las plantillas de inscripción Platinum SDK se deben convertir a un formato compatible para que funcionen con estos SDK.
Consulte el Apéndice B en la página 114 para obtener un código de muestra que convierte las plantillas Platinum SDK a este formato.
Inicio rápido 2
Este capítulo proporciona una introducción rápida a One Touch para Windows SDK: .NET Edition utilizando una de las aplicaciones de
muestra proporcionadas como parte de One Touch para Windows SDK.
La aplicación es un proyecto de Microsoft Visual Studio 2005 que demuestra la funcionalidad de las interfaces gráficas de usuario incluidas en
los objetos DPFP.Gui.Enrollment.EnrollmentControl y DPFP.Gui.Verification.VerificationControl . Las interfaces gráficas
de usuario se describen con más detalle en DPFP.Gui.Enrollment Interfaz gráfica de usuario en la página 94 y DPFP.Gui.Verification
Interfaz gráfica de usuario en la página 103.
Conceptos rápidos
Las siguientes definiciones lo ayudarán a comprender el propósito y la funcionalidad de la aplicación de muestra que se describe en
esta sección.
Inscripción: el proceso de capturar la huella dactilar de una persona cuatro veces, extraer las características de las huellas dactilares,
crear una plantilla de huellas dactilares y almacenar la plantilla para una comparación posterior.
Verificación: el proceso de comparar una huella digital capturada con una plantilla de huella digital para determinar si las dos coinciden.
Cancelación de registro: el proceso de eliminar una plantilla de huella digital asociada con una huella digital previamente registrada.
Para obtener más descripciones de estos procesos, consulte el Capítulo 4 en la página 18.
Instalar el software
Antes de poder usar la aplicación de muestra, debe instalar One Touch para Windows SDK: .NET Edition, que incluye el entorno de tiempo
de ejecución (RTE).
Para instalar el SDK de One Touch para Windows: Edición .NET
1. En la carpeta SDK del paquete de software, abra el archivo Setup.exe y luego haga clic en Siguiente.
2. Siga las instrucciones de instalación tal como aparecen.
3. Reinicie su computadora.
Capítulo 2: Inicio rápido Conectar el lector de huellas dactilares
Conectar el lector de huellas dactilares
Conecte el lector de huellas dactilares al conector USB del sistema donde instaló el SDK.
Uso de la aplicación de muestra
Al realizar los ejercicios de esta sección, usted
Inicie la aplicación de muestra
Registrar una huella digital
Verificar una huella digital
Dar de baja (eliminar) una huella digital
Salir de la aplicación de muestra
Para iniciar la aplicación de muestra
Abra el archivo UISupportSample CS.exe ubicado en la <carpeta de
destino>\One Touch SDK\.NET\Samples\Visual Studio 2005\CSharp\UI
Support\Release.
Aparece el cuadro de diálogo Ejemplo de interfaz de usuario de CSharp .
Capítulo 2: Inicio rápido Uso de la aplicación de muestra
Registrar una huella digital consiste en escanear su huella digital cuatro veces con el lector de huellas digitales.
Para registrar una huella digital
1. En el cuadro de diálogo Ejemplo de interfaz de usuario de CSharp , haga clic en Registrar huellas digitales.
Aparecerá el cuadro de diálogo Registro de huellas dactilares .
2. En la "mano" derecha, haga clic en el dedo índice.
Aparece un segundo cuadro de diálogo Registro de huellas dactilares .
3. Con el lector de huellas dactilares, escanee su huella dactilar índice derecha.
4. Repita el paso 3 hasta que aparezca el mensaje La inscripción se realizó correctamente .
5. Haga clic en Cerrar.
Para verificar una huella digital
1. En el cuadro de diálogo Ejemplo de interfaz de usuario de CSharp , haga clic en Verificar huella digital.
Aparece el cuadro de diálogo Verificar su identidad .
2. Con el lector de huellas dactilares, escanee su huella dactilar índice derecha.
En el cuadro de diálogo Verificar su identidad , aparece una marca de verificación verde sobre la huella digital, lo que indica que se
verificó su huella digital.
3. Con el lector de huellas dactilares, escanee su huella dactilar del medio derecho.
En el cuadro de diálogo Verificar su identidad , aparece un signo de interrogación rojo sobre la huella digital, lo que indica que su huella
digital no se verificó.
4. Haga clic en Cerrar.
Para dar de baja (eliminar) una huella digital
1. En el cuadro de diálogo Ejemplo de interfaz de usuario de CSharp , haga clic en Registrar huellas digitales.
Aparece el cuadro de diálogo Registro de huellas dactilares , que indica que ha registrado su huella dactilar índice derecha.
2. En la "mano" derecha, haga clic en el dedo índice verde.
Aparece un cuadro de mensaje que le solicita que verifique la eliminación (cancelación de la inscripción).
3. En el cuadro de mensaje, haga clic en Sí.
Aparece el mensaje Huella digital eliminada .
El dedo índice derecho ya no es verde, lo que indica que la huella digital asociada con ese dedo no está registrada o se ha eliminado.
Para salir de la aplicación
En el cuadro de diálogo Ejemplo de interfaz de usuario de CSharp , haga clic en Salir.
Instalación 3
Este capítulo contiene instrucciones para instalar los diversos componentes de One Touch para Windows SDK: .NET Edition e identifica los
archivos y carpetas que están instalados en su disco duro.
Las siguientes dos instalaciones se encuentran en el paquete de software SDK:
SDK, que utiliza para desarrollar su aplicación. Esta instalación se encuentra en la carpeta SDK.
RTE (entorno de tiempo de ejecución), que debe proporcionar a sus usuarios finales para implementar los componentes de la API de
One Touch para Windows SDK: .NET Edition. Esta instalación se encuentra en la carpeta RTE. (La instalación de RTE también
se incluye en la instalación de SDK).
Instalación del SDK
NOTA: Todas las instalaciones comparten las DLL y el archivo DPHostW.exe que se instalan con la edición C/C++.
Se proporcionan archivos adicionales específicos del producto para otras ediciones.
Para instalar One Touch para Windows SDK: .NET Edition para sistemas operativos de 32 bits
1. En la carpeta SDK del paquete de software SDK, abra el archivo Setup.exe y luego haga clic en Siguiente.
Para instalar One Touch para Windows SDK: .NET Edition para sistemas operativos de 64 bits
1. En la carpeta SDK\x64 del paquete de software SDK, abra el archivo Setup.exe y luego haga clic en Siguiente.
La Tabla 1 describe los archivos y carpetas que están instalados en la carpeta <carpeta de destino> en su disco duro para las instalaciones de
32 y 64 bits. Los archivos y carpetas RTE, que se describen en la Tabla 2 en la página 15 para la instalación de 32 bits y en la Tabla 3 en la
página 16 para la instalación de 64 bits, también se instalan en su disco duro.
Capítulo 3: Instalación Instalación del entorno de tiempo de ejecución (RTE)
Tabla 1. Archivos y carpetas instalados de One Touch para Windows SDK: .NET Edition
Carpeta Archivo Descripción
SDK de un toque\.NET\Bin DPFPShrNET.dll DLL utilizadas por One Touch para Windows: API de .NET

Edition
DPFPDevNET.dll
DPFPEngNET.dll
DPFPVerNET.dll
DPFPGuiNET.dll
DPFPCtlXLib.dll
DPFPCtlXTypeLibNET.dll
DPFPCtlXWrapperNET.dll
DPFPShrXTypeLibNET.dll
One Touch SDK\.NET\Docs One Touch para Windows SDK .NET DigitalPersona One Touch para SDK de Windows: Guía para

Developer Guide.pdf desarrolladores de la edición .NET
One Touch SDK\.NET\ Esta carpeta contiene un proyecto de muestra de Microsoft Visual Basic 2005 que muestra cómo usar One
Muestras\Visual Studio 2005\ Touch para Windows: API de edición .NET para realizar el registro y la verificación de huellas
VBNET\Inscripción digitales.
One Touch SDK\.NET\ Esta carpeta contiene un proyecto de muestra de Microsoft Visual Basic 2005 que muestra la funcionalidad
Samples\Visual Studio 2005\ de las interfaces gráficas de usuario contenidas en los espacios de nombres
VBNET\UI Support DPFP.Gui.Enrollment y DPFP.Gui.Verification de One Touch para Windows: API de .NET Edition.
One Touch SDK\.NET\ Esta carpeta contiene un proyecto de muestra de Microsoft® Visual C#® 2005 que muestra cómo usar One
Muestras\Visual Studio 2005\ Touch para Windows: .NET Edition API para realizar el registro y la verificación de huellas digitales.
CSharp\Inscripción
One Touch SDK\.NET\ Esta carpeta contiene un proyecto de muestra de Microsoft Visual C# 2005 que muestra la funcionalidad de las
Samples\Visual Studio 2005\ interfaces gráficas de usuario incluidas en los espacios de nombres DPFP.Gui.Enrollment y DPFP.Gui.Verification
CSharp\UI Support de One Touch para Windows: API de .NET Edition.
Instalación del entorno de tiempo de ejecución (RTE)
Cuando desarrolla un producto basado en One Touch para Windows SDK: .NET Edition, debe proporcionar los redistribuibles a sus
usuarios finales. Estos archivos están diseñados y autorizados para su uso con su aplicación. Puede incluir los archivos de instalación
ubicados en la carpeta RTE\Install en su aplicación o puede incorporar los redistribuibles directamente en su instalador. También
puede usar los módulos de combinación ubicados en la carpeta Redist en el paquete de software SDK para crear su propio instalador
MSI. (Consulte Redistribución en la página 105 para conocer los términos de la licencia).
Si creó una aplicación basada en One Touch para Windows: .NET Edition API que no incluye un instalador, sus usuarios finales
deben instalar One Touch para Windows: .NET Edition Runtime Environment para ejecutar su aplicación.
Para instalar One Touch para Windows: .NET Edition Runtime Environment para sistemas operativos de 32 bits
1. En la carpeta RTE del paquete de software SDK, abra el archivo Setup.exe.
La Tabla 2 identifica los archivos que están instalados en su disco duro para las versiones de 32 bits de los sistemas operativos
compatibles.
Tabla 2. One Touch para Windows: archivos y carpetas instalados de .NET Edition RTE, instalación de 32 bits
<carpeta de destino>\Bin DPCOper2.dll DLL y archivo ejecutable utilizado por todos los

One Touch para las API de Windows
DPDevice2.dll
DPDevTS.dll
DpHostW.exe
DPmsg.dll
DPMux.dll
DpSvInfo2.dll
DPTSClnt.dll
DPCrStor.dll
GlobalAssemblyCacheGlobalAssemblyCache DPFPShrNET.dll DLL utilizadas por One Touch para Windows: API de .NET

Edition
DPFPDevNET.dll
DPFPEngNET.dll
DPFPVerNET.dll
DPFPGuiNET.dll
DPFPCtlXLib.dll
<carpeta del sistema> DPFPApi.dll DLL utilizadas por todos los One Touch para Windows

API
DpClback.dll
dpHFtrEx.dll
dphMatch.dll
DPFpUI.dll
Para instalar One Touch para Windows: .NET Edition Runtime Environment para sistemas operativos de 64 bits
1. En la carpeta RTE\x64 del paquete de software SDK, abra el archivo Setup.exe.
La Tabla 3 identifica los archivos que están instalados en su disco duro para las versiones de 64 bits de los sistemas operativos
compatibles.
Tabla 3. One Touch para SDK de Windows: archivos y carpetas instalados de .NET Edition RTE, instalación de 64 bits
<carpeta de destino>\Bin DPCOper2.dll DLL y archivo ejecutable utilizado por todos los

One Touch para las API de Windows
DPDevice2.dll
DPDevTS.dll
DpHostW.exe
DPMux.dll
DpSvInfo2.dll
DPTSClnt.dll
DPCrStor.dll
<carpeta de destino>\Bin\x64 DPmsg.dll DLL utilizado por todos los de One Touch para
API de Windows
GlobalAssemblyCacheGlobalAssemblyCache DPFPShrNET.dll DLL utilizadas por One Touch para Windows: API de .NET

Edition
DPFPDevNET.dll
DPFPEngNET.dll
DPFPVerNET.dll
DPFPGuiNET.dll
DPFPCtlXLib.dll
DigitalPersona One Touch para Windows SDK: Edición .NET | Guía del desarrollador dieciséis
Capítulo 3: Instalación Instalación y desinstalación silenciosa de RTE
Tabla 3. One Touch para SDK de Windows: archivos y carpetas instalados de .NET Edition RTE, instalación de 64 bits (continuación)
<carpeta del sistema> DPFPApi.dll DLL de 32 bits utilizados por todos los One Touch para

API de Windows
DpClback.dll
dpHFtrEx.dll
dphMatch.dll
DPFpUI.dll
<carpeta system64> DPFPApi.dll DLL de 64 bits utilizados por todos los One Touch para

API de Windows
DpClback.dll
dpHFtrEx.dll
dphMatch.dll
DPFpUI.dll
Instalación y desinstalación silenciosa de RTE
El paquete de software SDK de One Touch para Windows contiene un archivo por lotes, InstallOnly.bat, que puede usar para instalar RTE de forma silenciosa.
Además, puede modificar el archivo para instalar selectivamente las diversas funciones del RTE.
Consulte el archivo para obtener instrucciones.
El paquete de software SDK también contiene un archivo, UninstallOnly.bat, que puede usar para desinstalar silenciosamente el RTE.
Descripción general 4
Este capítulo presenta los conceptos y la terminología de One Touch para Windows SDK: .NET Edition. Este capítulo también incluye
diagramas de flujo de trabajo típicos y explicaciones de las funciones de la API de One Touch para Windows: .NET Edition utilizadas para
realizar las tareas en los flujos de trabajo. Para obtener más información sobre la biometría de huellas dactilares, consulte el
"Informe técnico de DigitalPersona: Guía para el reconocimiento de huellas dactilares" incluido en la carpeta Docs del paquete de
software One Touch para Windows SDK.
Sistema Biométrico
Un sistema biométrico es un método automático para identificar a una persona en función de sus características físicas y/o de
comportamiento únicas, como una huella dactilar o un patrón de iris, una firma manuscrita o una voz. Los identificadores biométricos
son
Universal
Distintivo
Persistente (suficientemente inmutable en el tiempo)
Coleccionable
Los sistemas biométricos se han convertido en un componente esencial de las soluciones efectivas de reconocimiento de personas
porque los identificadores biométricos no se pueden compartir ni extraviar y, naturalmente, representan la identidad corporal de un individuo.
Las formas sustitutas de identidad, como las contraseñas (comúnmente utilizadas en el control de acceso lógico) y las tarjetas de
identidad (utilizadas con frecuencia para el control de acceso físico), no brindan este nivel de autenticación que valida fuertemente el
vínculo con el usuario autorizado real.
El reconocimiento de huellas dactilares es el sistema biométrico más popular y maduro que se utiliza en la actualidad. Además de
cumplir con los cuatro criterios anteriores, los sistemas de reconocimiento de huellas dactilares funcionan bien (es decir, son precisos,
rápidos y robustos), son aceptables públicamente y son difíciles de eludir.
Huella dactilar
Una huella dactilar es una impresión de las crestas en la piel de un dedo. Un sistema de reconocimiento de huellas dactilares utiliza
las características distintivas y persistentes de las crestas, también conocidas como características de huellas dactilares, para distinguir
un dedo (o persona) de otro. One Touch para Windows SDK: .NET Edition incorpora DigitalPersona Fingerprint Recognition
Engine (Engine), que utiliza metodologías tradicionales y modernas de reconocimiento de huellas dactilares para convertir estas
características de huellas dactilares en un formato compacto, distintivo y persistente. Luego, el motor utiliza las funciones de huellas
dactilares convertidas o extraídas en la comparación y la toma de decisiones para proporcionar un reconocimiento personal
confiable.
Capítulo 4: Resumen Reconocimiento de huellas dactilares
Reconocimiento de huellas dactilares
El sistema de reconocimiento de huellas dactilares DigitalPersona utiliza los procesos de inscripción y verificación de huellas dactilares, que se ilustran
en el diagrama de bloques de la Figura 1 en la página 20. Algunas de las tareas de estos procesos las realiza el lector de huellas dactilares y
su controlador; algunas se logran usando One Touch para Windows: funciones API de .NET Edition, que usan el motor; y algunos son
proporcionados por su aplicación de software y/o hardware.
Inscripción de huellas dactilares
El registro de huellas dactilares es el proceso inicial de recopilar datos de huellas dactilares de una persona (inscrito) y almacenar los datos resultantes
como una plantilla de huellas dactilares para una comparación posterior. El siguiente procedimiento describe el registro típico de huellas
dactilares. (Los pasos precedidos por un asterisco no los realiza One Touch para Windows SDK: .NET Edition).
1. *Obtener el identificador del afiliado (Identificador de Sujeto).
2. Capture la huella dactilar del afiliado usando el lector de huellas dactilares.
3. Extraiga el conjunto de funciones de huellas dactilares con el propósito de inscripción de la muestra de huellas dactilares.
4. Repita los pasos 2 y 3 hasta que tenga suficientes conjuntos de funciones de huellas dactilares para crear una plantilla de huellas dactilares.
5. Cree una plantilla de huella digital.
6. *Asocie la plantilla de huella digital con el inscrito a través de un identificador de sujeto, como un nombre de usuario,
dirección de correo electrónico o número de empleado.
7. *Guarde la plantilla de la huella dactilar, junto con el identificador de sujeto, para compararlos más tarde.
Las plantillas de huellas dactilares se pueden almacenar en cualquier tipo de repositorio que elija, como un dispositivo de captura de
huellas dactilares, una tarjeta inteligente o una base de datos local o central.
Verificación de huellas dactilares
La verificación de huellas dactilares es el proceso de comparar los datos de las huellas dactilares con la plantilla de huellas dactilares producida en el
momento de la inscripción y decidir si las dos coinciden. El siguiente procedimiento describe la verificación típica de huellas dactilares.
(Los pasos precedidos por un asterisco no los realiza One Touch para Windows SDK: .NET Edition).
1. *Obtener el Identificador de Sujeto de la persona a verificar.
2. Capture una muestra de huellas dactilares con el lector de huellas dactilares.
3. Extraiga un conjunto de funciones de huellas dactilares con fines de verificación de la muestra de huellas dactilares.
4. *Recupere la plantilla de huella digital asociada con el identificador de sujeto de su repositorio.
Capítulo 4: Resumen Falsos positivos y falsos negativos
5. Realice una comparación uno a uno entre el conjunto de funciones de huellas dactilares y la plantilla de huellas dactilares, y
tomar una decisión de coincidencia o no coincidencia.
6. *Actuar de acuerdo con la decisión, por ejemplo, abrir la puerta de un edificio para un partido o denegar el acceso a
el edificio por un no partido.
Figura 1. Sistema de reconocimiento de huella digital DigitalPersona
Falsos positivos y falsos negativos
Los sistemas de reconocimiento de huellas dactilares brindan muchas ventajas de seguridad y conveniencia sobre los métodos tradicionales de
reconocimiento. Sin embargo, son esencialmente sistemas de reconocimiento de patrones que inherentemente ocasionalmente cometen ciertos
errores, porque no hay dos impresiones del mismo dedo que sean idénticas. Durante la verificación, a veces el sistema rechaza a una persona
que está inscrita legítimamente (una decisión de falso negativo) y, a veces, el sistema acepta a una persona que no está inscrita (una decisión
de falso positivo).
La proporción de decisiones falsas positivas se conoce como tasa de aceptación falsa (FAR), y la proporción de decisiones negativas falsas se
conoce como tasa de rechazo falso (FRR). En los sistemas de reconocimiento de huellas dactilares, la FAR y la FRR se compensan entre sí, es
decir, cuanto menor sea la FAR, mayor será la FRR, y cuanto mayor sea la FAR, menor será la FRR.
Capítulo 4: Resumen Flujos de trabajo
Una función API de One Touch para Windows: .NET Edition le permite establecer el valor de FAR, también denominado nivel de seguridad, para adaptarse a
las necesidades de su aplicación. En algunas aplicaciones, como un sistema de control de acceso a un sitio o base de datos altamente confidencial,
se requiere un FAR más bajo. En otras aplicaciones, como un sistema de entrada a un parque temático de entretenimiento, la seguridad (que reduce el fraude
de boletos cometido por una pequeña fracción de usuarios al compartir sus boletos de entrada) puede no ser tan importante como la accesibilidad
para todos los usuarios, y puede ser preferible disminuir la FRR a expensas de aumentar la FAR.
Es importante recordar que la precisión del sistema de reconocimiento de huellas dactilares está relacionada en gran medida con la calidad de la huella
dactilar. Las pruebas con grupos considerables de personas durante un período prolongado han demostrado que la mayoría de las personas tienen
huellas dactilares ricas en funciones y de alta calidad. Es casi seguro que estas huellas dactilares serán reconocidas con precisión por
DigitalPersona Fingerprint Recognition Engine y prácticamente nunca serán aceptadas o rechazadas falsamente. El sistema de reconocimiento de huellas
dactilares de DigitalPersona está optimizado para reconocer huellas dactilares de mala calidad. Sin embargo, un número muy reducido de personas
puede tener que intentarlo una segunda o incluso una tercera vez para obtener una lectura precisa. Sus huellas dactilares pueden ser difíciles de verificar
porque están desgastadas por el trabajo manual o tienen crestas ilegibles. La instrucción sobre el uso adecuado del lector de huellas dactilares ayudará a
estas personas a lograr los resultados deseados.
Flujos de trabajo
En esta sección se presentan flujos de trabajo típicos para las siguientes operaciones:
Inscripción de huellas dactilares
Inscripción de huellas dactilares con soporte de interfaz de usuario
Verificación de huellas dactilares con soporte de interfaz de usuario
Serialización y deserialización de objetos de datos de huellas dactilares
NOTA: Los pasos precedidos por dos asteriscos (**) los realiza un lector de huellas dactilares, y los pasos precedidos por un asterisco
(*) son realizados por una aplicación.
Flujo de trabajo de registro de huellas dactilares
Esta sección contiene un flujo de trabajo típico para realizar el registro de huellas dactilares. El flujo de trabajo se ilustra en la Figura 2 y va seguido de
explicaciones de las funciones de la API de One Touch para Windows: .NET Edition utilizadas para realizar las tareas del flujo de trabajo. El flujo de
trabajo de su aplicación puede ser diferente al que se ilustra aquí. Por ejemplo, puede elegir crear conjuntos de funciones de huellas dactilares localmente y
luego enviarlos a un servidor para su registro.
Capítulo 4: Resumen Flujo de trabajo de registro de huellas dactilares
Figura 2. Flujo de trabajo típico de registro de huellas dactilares
Captura de muestra de huellas dactilares (DPFP.Capture.Capture Class)
1. Cree una nueva instancia de la clase DPFP.Capture.Capture (página 46).
IMPORTANTE: No puede cambiar la prioridad o la configuración de los lectores de una DPFP.Capture.Capture
objeto después de la construcción.
2. Cargue un controlador de eventos de operación de captura de muestras de huellas dactilares para recibir notificaciones de eventos configurando el
Propiedad EventHandler (página 50).
3. Comience a capturar muestras de huellas dactilares de los lectores de huellas dactilares conectados a un sistema llamando al
Método StartCapture() (página 48).
4. **Capture una muestra de huellas dactilares de un lector de huellas dactilares.
5. *Reciba el evento OnComplete del controlador de eventos de la operación de captura de muestras de huellas dactilares junto
con un objeto DPFP.Sample cuando el lector de huellas dactilares capture correctamente la muestra de huellas dactilares
(página 65).
6. *Pase el objeto DPFP.Sample a DPFP.Processing.FeatureExtraction.
Método CreateFeatureSet(Sample, DataPurpose, ref CaptureFeedback, ref FeatureSet) . (Consulte el paso
2 en la siguiente sección).
7. Deje de capturar muestras de huellas dactilares llamando al método StopCapture (página 49).
Extracción de características de huellas dactilares (clase DPFP.Processing.FeatureExtraction)
1. Cree una nueva instancia de la clase DPFP.Processing.FeatureExtraction (página 83).
2. Cree objetos DPFP.FeatureSet llamando a CreateFeatureSet(Sample,
DataPurpose, ref CaptureFeedback, ref FeatureSet) usando el valor Inscripción para DataPurpose y pasando el
objeto DPFP.Sample del paso 6 de la sección anterior (página 83).
3. *Pase los objetos DPFP.FeatureSet creados en el paso anterior al método AddFeatures .
(Consulte el paso 2 en la siguiente sección).
Registro de huellas dactilares (DPFP.Processing.Enrollment Class)
1. Cree una nueva instancia de la clase DPFP.Processing.Enrollment (página 85).
2. Realice la función del sistema de inscripción de huellas dactilares llamando al método AddFeatures(FeatureSet) y pasando
los objetos DPFP.FeatureSet del paso 3 de la sección anterior (página 85).
3. Compruebe la propiedad TemplateStatus después de cada llamada al método AddFeatures (página 87).
Cuando la propiedad TemplateStatus devuelve el valor Listo, se crea un objeto DPFP.Template .
4. *Recibir el objeto DPFP.Template .
5. Serialice el objeto DPFP.Template (consulte Serialización de un objeto de datos de huellas dactilares en la página 34).
6. *Almacene los datos de la plantilla de huellas dactilares serializadas en un subsistema de almacenamiento de datos de huellas dactilares.
7. Borre la plantilla de huellas dactilares y establezca el valor de TemplateStatus en Desconocido llamando al método Clear() (página
86).
Capítulo 4: Resumen Inscripción de huellas dactilares con soporte de interfaz de usuario
Inscripción de huellas dactilares con soporte de interfaz de usuario
Esta sección contiene dos flujos de trabajo típicos para realizar el registro de huellas digitales: uno para registrar una huella digital y
otro para cancelar el registro (eliminar) una huella digital. Los flujos de trabajo se ilustran en la Figura 3 y la Figura 4 y van seguidos de
explicaciones de las funciones de la API de One Touch para Windows: .NET Edition utilizadas para realizar las tareas en los flujos de trabajo.
Registro de una huella digital
Figura 3. Inscripción típica de huellas dactilares con flujo de trabajo de soporte de UI: Inscripción de una huella dactilar
1. Cree una nueva instancia de la clase DPFP.Gui.Enrollment.EnrollmentControl (página 70).
2. Configure la propiedad EnrolledFingerMask (página 70).
3. Opcionalmente, establezca las propiedades MaxEnrollFingerCount y ReaderSerialNumber (página 72
y página 72).
4. Cargue un controlador de eventos de control de registro de huellas dactilares para recibir notificaciones de eventos configurando el
5. **Capture un número predeterminado de muestras de huellas dactilares de un lector de huellas dactilares.
6. *Reciba el evento OnEnroll del controlador de eventos de control de inscripción de huellas digitales, junto con el
Objeto DPFP.Template (página 75).
7. Serialice el objeto DPFP.Template (consulte Serialización de un objeto de datos de huellas dactilares en la página 34).
8. *Almacene los datos de la plantilla de huellas dactilares serializadas y el nuevo valor de EnrolledFingerMask en un
subsistema de almacenamiento de datos de huellas dactilares.
9. *Establezca el valor apropiado para el objeto DPFP.Gui.EventHandlerStatus (página 69).
Anulación de la inscripción (eliminación) de una plantilla de huellas dactilares
Figura 4. Flujo de trabajo típico de registro de huellas dactilares con soporte de IU: anulación de registro (eliminación) de una huella dactilar
1. Cree una nueva instancia de la clase DPFP.Gui.Enrollment.EnrollmentControl (página 70).
2. *Recuperar el valor de EnrolledFingerMask almacenado en el subsistema de almacenamiento de datos de huellas dactilares.
3. Configure la propiedad EnrolledFingerMask (página 70).
4. Cargue un controlador de eventos de control de registro de huellas dactilares para recibir notificaciones de eventos configurando el
5. * Recibir el evento OnDelete del controlador de eventos de control de inscripción, junto con el índice del dedo
(página 79 y página 74).
6. *Elimine la plantilla de huellas dactilares adecuada del subsistema de almacenamiento de datos de huellas dactilares.
7. *Almacene el nuevo valor de EnrolledFingerMask en el subsistema de almacenamiento de datos de huellas dactilares.
Capítulo 4: Resumen Verificación de huellas dactilares
Esta sección contiene un flujo de trabajo típico para realizar la verificación de huellas dactilares. El flujo de trabajo se ilustra en
la Figura 5 y va seguido de explicaciones de las funciones de la API de One Touch para Windows: .NET Edition utilizadas
para realizar las tareas en el flujo de trabajo.
Figura 5. Flujo de trabajo típico de verificación de huellas dactilares
Captura de muestra de huellas dactilares (DPFP.Capture.Capture Class)
1. Cree una nueva instancia de la clase DPFP.Capture.Capture (página 46).
IMPORTANTE: No puede cambiar la prioridad o la configuración de los lectores de una DPFP.Capture.Capture
objeto después de la construcción.
2. Cargue un controlador de eventos de operación de captura de muestras de huellas dactilares para recibir notificaciones de eventos configurando el
3. Comience a capturar muestras de huellas dactilares de los lectores de huellas dactilares conectados a un sistema llamando al
Método StartCapture() (página 48).
5. *Reciba el evento OnComplete del controlador de eventos de la operación de captura de muestras de huellas dactilares junto con
un objeto DPFP.Sample cuando el lector de huellas dactilares capture correctamente la muestra de huellas dactilares (página 65).
6. *Pase el objeto DPFP.Sample a DPFP.Processing.FeatureExtraction.
Método CreateFeatureSet(Sample, DataPurpose, ref CaptureFeedback, ref FeatureSet) . (Consulte el paso 2 en
la siguiente sección).
7. Deje de capturar muestras de huellas dactilares llamando al método StopCapture (página 49).
Extracción de características de huellas dactilares (clase DPFP.Processing.FeatureExtraction)
1. Cree una nueva instancia de la clase DPFP.Processing.FeatureExtraction (página 83).
2. Cree objetos DPFP.FeatureSet llamando a CreateFeatureSet(Sample,
DataPurpose, ref CaptureFeedback, ref FeatureSet) usando el valor Verification for DataPurpose y pasando el objeto
DPFP.Sample del paso 6 de la sección anterior (página 83).
3. *Pase el objeto DPFP.FeatureSet creado en el paso anterior a DPFP.Verification.
Método Verification.Verify(FeatureSet, Template, ref Result) . (Consulte el paso 5 en la siguiente sección).
Verificación de huellas dactilares (DPFP.Verification.Verification Class)
1. Cree una nueva instancia de la clase DPFP.Verification.Verification (página 90).
2. Opcionalmente, establezca la propiedad FARRequested (página 92). Puede usar esta propiedad para establecer o cambiar
el valor de la FAR del valor predeterminado o de un valor especificado.
3. *Recuperar datos de plantillas de huellas dactilares serializadas del subsistema de almacenamiento de datos de huellas dactilares.
4. Cree un objeto DPFP.Template a partir de los datos serializados (consulte Deserializar datos de huellas dactilares serializados
Objeto en la página 35).
5. Realice la función del sistema de verificación de huellas dactilares llamando a Verify(FeatureSet,
Template, ref Result) y pasando el objeto DPFP.Template creado en el paso anterior y el objeto
DPFP.FeatureSet del paso 3 de la sección anterior (página 91).
6. *Recibir el objeto DPFP.Verification.Result , que proporciona la decisión de comparación de coincidencia
o no coincidencia (página 93).
Capítulo 4: Resumen Verificación de huellas dactilares con soporte de interfaz de usuario
Verificación de huellas dactilares con soporte de interfaz de usuario
Esta sección contiene un flujo de trabajo típico para realizar la verificación de huellas dactilares con soporte de interfaz de usuario. El flujo de trabajo se ilustra en la
Figura 6 y va seguido de explicaciones de las funciones de la API de One Touch para Windows: .NET Edition utilizadas para realizar las tareas del flujo de trabajo.
Figura 6. Flujo de trabajo típico de verificación de huellas dactilares con soporte de interfaz de usuario
Capítulo 4: Resumen Verificación de huellas dactilares con soporte de interfaz de usuario
Control de verificación de huellas dactilares (DPFP.Gui.Verification.VerificationControl Class)
1. Cree una nueva instancia de la clase DPFP.Gui.Verification.VerificationControl (página 80).
2. Opcionalmente, configure la propiedad ReaderSerialNumber (página 81).
3. Cargue un controlador de eventos de control de verificación de huellas dactilares para recibir notificaciones de eventos configurando el
5. Reciba el evento OnComplete del controlador de eventos de control de verificación de huellas digitales junto con el
Objeto DPFP.FeatureSet (página 82).
Verificación de huellas dactilares (DPFP.Verification.Verification Class)
1. Cree una nueva instancia de la clase DPFP.Verification.Verification (página 90).
2. Opcionalmente, establezca la propiedad FARRequested (página 92). Puede usar esta propiedad para establecer o cambiar
el valor de la FAR del valor predeterminado o de un valor especificado.
3. *Recuperar datos de plantillas de huellas dactilares serializadas del subsistema de almacenamiento de datos de huellas dactilares.
4. Cree un objeto DPFP.Template a partir de datos serializados (consulte Deserializar datos de huellas dactilares serializados
Objeto en la página 35).
5. Realice la función del sistema de verificación de huellas dactilares llamando a Verify(FeatureSet,
Template, ref Result) y pasando los objetos DPFP.Template y DPFP.FeatureSet (página 91).
6. *Recibir el objeto DPFP.Verification.Result , que proporciona la decisión de comparación de coincidencia o no coincidencia
(página 93).
Capítulo 4: Resumen Serialización/deserialización de objetos de datos de huellas dactilares
Serialización/deserialización de objetos de datos de huellas dactilares
Esta sección contiene dos flujos de trabajo: uno para serializar un objeto de datos de huellas dactilares y otro para deserializar un
objeto de datos de huellas dactilares serializado. Los flujos de trabajo se ilustran en la Figura 7 y la Figura 8 y van seguidos de
explicaciones de las funciones de la API de One Touch para Windows: .NET Edition utilizadas para realizar las tareas en los flujos
de trabajo.
Serialización de un objeto de datos de huellas dactilares
Figura 7. Flujo de trabajo de serialización de objetos de datos de huellas dactilares: objeto DPFP.Template
1. Comience con un objeto DPFP.Template . (Consulte DPFP.Clase de plantilla en la página 43 para obtener más información sobre
cómo se construye o suministra un objeto DPFP.Template ).
2. Serialice el objeto DPFP.Template llamando al método DPFP.Template.Serialize(byte[]) o DPFP.Template.Serialize(Stream) (página
38 y página 39).
3. *Almacene los datos de la plantilla de huellas dactilares serializadas en un subsistema de almacenamiento de datos de huellas dactilares.
Capítulo 4: Resumen Serialización/deserialización de objetos de datos de huellas dactilares
Deserializar un objeto de datos de huellas dactilares serializados
Figura 8. Deserialización del flujo de trabajo de objetos de datos de huellas dactilares serializados: objeto DPFP.Template
1. *Recuperar datos de plantillas de huellas dactilares serializadas de un subsistema de almacenamiento de datos de huellas dactilares.
2. Deserialice un objeto DPFP.Template llamando al constructor DPFP.Template(Stream) o al método
DPFP.Template.DeSerialize(byte[]) o DPFP.Template.DeSerialize(Stream) (página 38, página 39 y página 40, respectivamente).
3. Devuelva un objeto DPFP.Template .
Referencia de la API 5
Este capítulo define los componentes para desarrollar aplicaciones que incorporan la funcionalidad de One Touch para Windows: .NET
Edition API.
IMPORTANTE: Todas las propiedades de lectura/escritura de One Touch para Windows: los componentes de la API de .NET Edition
son opcionales. Si no establece una de estas propiedades, se utiliza automáticamente el valor predeterminado. Al
decidir si establecer una propiedad, tenga en cuenta que DigitalPersona puede cambiar los valores predeterminados
en cualquier momento sin previo aviso. Si desea que la funcionalidad de su aplicación permanezca consistente,
debe configurar las propiedades en consecuencia.
Excepciones
One Touch para Windows SDK: .NET Edition emplea ampliamente el mecanismo de excepción de .NET para indicar una operación
fallida. Dado que el SDK a veces devuelve un valor/código de retorno en la invocación de la función, se recomienda enfáticamente
que utilice un control de excepciones eficaz al llamar a la API.
Todas las excepciones específicas de SDK se empaquetan dentro de la clase DPFP.Error.SDKException y deben atraparse en
consecuencia. Las secciones de Excepciones en esta referencia de API enumeran las posibilidades de entrega para cada método
de cada objeto SDK.
La clase DPFP.Error.SDKException amplía ApplicationException agregando la propiedad ErrorCode definida en la página 43,
que devuelve un valor enumerado de DPFP.Error.ErrCodes (página 44).
La clase DPFP.Error.SDKException también proporciona más información a través de las siguientes propiedades:
Mensaje: una cadena que detalla la naturaleza de la excepción.
InnerException: una System.Exception que detalla aún más la naturaleza de la excepción
Capítulo 5: Referencia de la API Componentes
Componentes
La API de One Touch para Windows: .NET Edition incluye los componentes definidos en el resto de este
capítulo. Utilice la siguiente lista para ubicar rápidamente un componente por nombre, número de página o descripción.
Componente descripcion de PAGINA
Compartido 38 Este componente está envuelto dentro del espacio de nombres DPFP . Los miembros de este componente
son compartidos por otros componentes de One Touch para Windows: API de .NET Edition. Este
componente siempre está instalado.
Captura 46 Este componente está envuelto dentro del espacio de nombres DPFP.Capture . Los miembros de este
componente
Capture muestras de huellas dactilares de lectores de huellas dactilares
Eventos de incendio de lectores de huellas dactilares
Proporcionar información sobre los lectores de huellas dactilares conectados a un sistema
Convertir una muestra de huella digital en una imagen
interfaz gráfica de usuario 69 Este componente está incluido en el espacio de nombres DPFP.Gui , que proporciona interfaces
gráficas de usuario para realizar operaciones de inscripción y verificación de huellas dactilares y
comentarios sobre el estado del controlador de eventos. Los espacios de nombres DPFP.Gui.Enrollment
y DPFP.Gui.Verification están incluidos en el espacio de nombres DPFP.Gui .
Procesando 83 Este componente está envuelto dentro del espacio de nombres DPFP.Processing . Los miembros de este
componente proporcionan métodos y propiedades para
Crear conjuntos de funciones de huellas dactilares con el propósito de inscripción o
verificación
Realización de la función del sistema de registro de huellas dactilares mediante la creación de
plantillas de huellas dactilares
Verificación 90 Este componente está envuelto dentro del espacio de nombres DPFP.Verification .
Los miembros de este componente proporcionan un método y propiedades para
Realización de la función del sistema de verificación de huellas dactilares
Devolución y recuperación de la tasa de aceptación falsa (FAR)
Devolver los resultados de la operación de verificación de huellas dactilares
Capítulo 5: Referencia de la API Componente compartido
Componente compartido
El componente compartido está envuelto dentro del espacio de nombres DPFP . Los miembros de este componente son compartidos
por otros componentes de One Touch para Windows: API de .NET Edition. Este componente siempre está instalado.
DPFP.Clase de datos
Representa los datos que son comunes a todos los objetos de datos de huellas dactilares. La clase Data también proporciona métodos
y propiedades para serializar y deserializar objetos de datos de huellas dactilares.
Constructores predeterminados
Datos()
Una clase base para todos los objetos de datos de huellas dactilares: DPFP.FeatureSet, DPFP.Sample y
DPFP.Template.
Sintaxis
datos públicos()
Flujo de datos)
Construye un objeto de datos a partir de un flujo dado.
Sintaxis
datos públicos (Stream DataStream)
Parámetro
Flujo de datos Flujo de datos para deserializar
Métodos públicos
Serializar(ref byte[])
Serializa un objeto de datos y lo devuelve como una matriz de bytes.
Sintaxis
public void serializar (
byte de referencia[] ArrayOfBytes
)
Capítulo 5: Referencia de la API DPFP.Clase de datos
Parámetro
Matriz de bytes Matriz de bytes que recibe y devuelve un objeto de datos serializados
Excepciones
DPFP.Error.ErrorCodes Mensaje Razón
Interno Mala serialización La serialización falló, probablemente debido a limitaciones de memoria o

argumentos incorrectos.
Deserializar(byte[])
Deserializa un objeto de datos devuelto por el método Serialize .
Sintaxis
public void DeSerialize( byte[]
ArrayOfBytes
)
Parámetros
Matriz de bytes Matriz de bytes que contiene un objeto de datos deserializado
Excepciones
Interno Mala deserialización La deserialización falló, probablemente debido a limitaciones

de memoria o argumentos incorrectos.
Serializar (Stream)
Serializa un objeto de datos en una secuencia.
Sintaxis
Public Stream Serialize (Stream DataStream)
Parámetro
Flujo de datos Flujo de datos
Capítulo 5: Referencia de la API DPFP.Clase de datos
Excepción
Interno Mala serialización La serialización falló, probablemente debido a limitaciones de memoria o

argumentos incorrectos.
Deserializar (Stream)
Deserializa un objeto de datos devuelto por el método Serialize .
Sintaxis
Deserialización de flujo público (Stream DataStream)
Parámetro
Flujo de datos Flujo de datos
Excepción

Propiedades públicas
bytes
Devuelve datos sin procesar incrustados.
Sintaxis
byte público [] bytes
Parámetro
bytes Matriz de bytes que recibe los datos sin procesar incrustados
Esta propiedad es de sólo lectura.
Tamaño
Devuelve el tamaño de los datos sin procesar incrustados, en bytes.
Capítulo 5: Referencia de la API Clase DPFP.FeatureSet
Sintaxis
tamaño int público
Parámetro
Tamaño Int que recibe el tamaño de los datos sin procesar incrustados, en bytes
Clase DPFP.FeatureSet
Representa un conjunto de funciones de huellas dactilares. El objeto DPFP.FeatureSet se proporciona en el parámetro FeatureSet del
método CreateFeatureSet (página 83) y mediante el evento OnComplete del controlador de eventos de control de verificación de
huellas digitales (página 82).
NOTA: La clase DPFP.FeatureSet hereda todos los métodos y propiedades públicos de DPFP.Data
clase.
Constructores Públicos
Conjunto de características()
Construye un objeto DPFP.FeatureSet .
Sintaxis
Conjunto de funciones público ()
Conjunto de funciones (flujo)
Construye un objeto DPFP.FeatureSet a partir de un flujo determinado.
Sintaxis
Conjunto de funciones público (Stream DataStream)
Parámetro
Capítulo 5: Referencia de la API DPFP.Clase de muestra
Excepción

DPFP.Clase de muestra
Representa una muestra de huellas dactilares capturada de un lector de huellas dactilares. El objeto DPFP.Sample lo proporciona el
evento OnComplete del controlador de eventos de la operación de captura de muestras de huellas dactilares (página 65).
NOTA: La clase DPFP.Sample hereda todos los métodos y propiedades públicos de la clase DPFP.Data .
Muestra()
Construye un objeto DPFP.Sample .
Sintaxis
Muestra pública ()
Muestra (flujo)
Construye un objeto DPFP.Sample a partir de un flujo determinado.
Sintaxis
Muestra pública (Stream DataStream)
Parámetro
Excepción

Capítulo 5: Referencia de la API DPFP.Clase de plantilla
DPFP.Clase de plantilla
Representa una plantilla de huella digital. El objeto DPFP.Template lo proporciona la propiedad Template (página 87) y el evento
OnEnroll del controlador de eventos de control de inscripción de huellas digitales (página 75).
NOTA: La clase DPFP.Template hereda todos los métodos y propiedades públicos de la clase DPFP.Data .
Plantilla()
Construye un objeto DPFP.Template .
Sintaxis
Plantilla pública ()
Plantilla (Flujo)
Construye un objeto DPFP.Template a partir de un flujo determinado.
Sintaxis
Plantilla pública (Stream DataStream)
Parámetro
Excepción

Clase DPFP.Error.SDKException
Proporciona excepciones específicas del SDK.
Propiedad pública
Código de error
Devuelve un código de error incrustado.
Capítulo 5: Referencia de la API Clase DPFP.Error.SDKException
Sintaxis
Códigos de error públicos Código de error
Valores posibles
Código de error Enumeración que recibe uno de los valores de DPFP.Error.ErrorCodes
Enumeración Pública
Códigos de error
Define los códigos de error devueltos por la clase SDKException .
Sintaxis
códigos de error de enumeración pública
{
Éxito = 0,
No Inicializado = 1,
Parámetro no válido = 2,
No implementado = 3,
IO = 4,
Sin memoria = 7,
Interno = 8,
Configuración incorrecta = 9,
Dispositivo desconocido = 10,
Búfer no válido = 11,
Conjunto de funciones demasiado corto = 16,
Contexto no válido = 17,
Tipo de conjunto de características no válido = 29,
Conjunto de características no válido = 32,
Desconocido = 33
}
Miembros
Éxito La función tuvo éxito.
No inicializado Faltan algunos componentes del motor o no se puede acceder a ellos.
Parametro invalido Uno o más parámetros no son válidos.
IO Se produjo un error de archivo de E/S genérico.
Sin memoria No hay suficiente memoria para realizar la acción.
Capítulo 5: Referencia de la API Biblioteca
Interno Se produjo un error interno desconocido.
Configuración incorrecta La configuración de inicialización está dañada.
Dispositivo desconocido El dispositivo solicitado no es conocido.
Búfer no válido Un búfer no es válido.
Conjunto de características demasiado corto El conjunto de funciones de huellas dactilares o el tamaño del búfer de la plantilla de huellas dactilares especificado es
demasiado pequeño.
Contexto no válido El contexto dado no es válido.
InvalidFeatureSetType El propósito del conjunto de características no es válido.
Conjunto de funciones no válido Las funciones de huellas dactilares descifradas no son válidas. El descifrado puede haber
fallado.
Desconocido Ocurrió una excepción desconocida.
Observaciones
Los miembros de esta enumeración son utilizados por la propiedad DPFP.Error.ErrorCode (página 43).
Biblioteca
DPFPShrNet.dll
Capítulo 5: Referencia de la API Componente de captura
Componente de captura
El componente de captura está envuelto dentro del espacio de nombres DPFP.Capture . Los miembros de este componente
Capture muestras de huellas dactilares de lectores de huellas dactilares
Eventos de incendio de lectores de huellas dactilares
Proporcionar información sobre los lectores de huellas dactilares conectados a un sistema
Convertir una muestra de huella digital en una imagen
DPFP.Capture.Clase de captura
Captura una muestra de huellas dactilares de un lector de huellas dactilares en particular o de todos los lectores de huellas dactilares
conectados a un sistema y puede especificar la prioridad para la operación de captura.
Captura (Cadena, Prioridad)
Inicializa una nueva instancia de la clase Capture para capturar una muestra de huellas dactilares de un lector de huellas dactilares
en particular utilizando su número de serie y especifica cualquier valor válido para la prioridad de la operación de captura.
Sintaxis
Captura pública (String ReaderSerialNumber, Priority CapturePriority)
Parámetros
ReaderSerialNumber Cadena que contiene un número de serie del lector de huellas dactilares
Prioridad de captura Enumeración que especifica uno de los valores de DPFP.Capture.
Prioridad (página 64)
Excepción
No inicializado No se pudo inicializar El SDK no pudo inicializarse correctamente, posiblemente debido

a una mala configuración, archivos binarios incompatibles o
limitaciones de seguridad/memoria.
Capítulo 5: Referencia de la API DPFP.Capture.Clase de captura
Capturar (cadena)
Inicializa una nueva instancia de la clase Capture para capturar una muestra de huellas dactilares de un lector de
huellas dactilares en particular utilizando su número de serie y asigna prioridad Normal a la operación de captura.
Sintaxis
Captura pública (String ReaderSerialNumber)
Parámetro
Excepción

Captura (Prioridad)
Inicializa una nueva instancia de la clase Capture para capturar una muestra de huellas dactilares de todos los lectores de
huellas dactilares conectados a un sistema y especifica cualquier valor válido para la prioridad de la operación de captura.
Sintaxis
Captura pública (prioridad de captura prioritaria)
Parámetro
Prioridad de captura Enumeración que especifica uno de los valores de DPFP.Capture.
Prioridad (página 64)
Excepción

Captura()
Inicializa una nueva instancia de la clase Capture para capturar una muestra de huellas dactilares de cualquiera de los lectores
de huellas dactilares conectados a un sistema y asigna prioridad Normal a la operación de captura.
Sintaxis
Captura pública ()
Excepción

Métodos públicos
Iniciar captura()
Comienza a capturar una muestra de huellas dactilares de un lector de huellas dactilares. Una llamada a este método es
asincrónica y regresa inmediatamente. Si se cargó un controlador de eventos de operación de captura de muestras
de huellas dactilares a través de la propiedad EventHandler , la aplicación recibe eventos del lector de huellas dactilares
(página 50). Cada llamada al método StartCapture() debe combinarse con una llamada al método StopCapture() .
Sintaxis
vacío público StartCapture ()
Excepción
No inicializado No se pudo inicializar El SDK no se pudo inicializar correctamente, posiblemente debido

Dispositivo desconocido No se pudo acceder al lector El ID del lector especificado no es válido o no
existir.
Interno Error al crear la adquisición La operación de captura de muestras de huellas dactilares no se pudo
inicializar.
Interno Error al iniciar la adquisición No se pudo iniciar la operación de captura de muestras de huellas dactilares.
DetenerCaptura()
Detiene la operación de captura de muestras de huellas dactilares iniciada con una llamada al método StartCapture() .
Sintaxis
vacío público StopCapture ()
Excepción

Prioridad
Devuelve un valor que especifica la prioridad de una operación de captura de muestras de huellas dactilares.
Sintaxis
público Prioridad Prioridad
Valores posibles
Prioridad Enumeración que recibe uno de los valores de DPFP.Capture.Priority (página 64)
Esta propiedad es de solo lectura y también se puede establecer mediante la construcción.
ReaderSerialNumber
Devuelve el número de serie de un lector de huellas dactilares que captura una muestra de huellas dactilares.
Sintaxis
cadena pública ReaderSerialNumber
Valores posibles
ReaderSerialNumber Cadena que recibe un número de serie del lector de huellas dactilares
Esta propiedad es de solo lectura y también se puede establecer mediante la construcción.
Capítulo 5: Referencia de la API Clase DPFP.Capture.ReaderDescription
Controlador de eventos
Carga un controlador de eventos de operación de captura de muestras de huellas dactilares. Establezca esta propiedad en nulo para borrar todos los controladores
de eventos registrados.
IMPORTANTE: Debe cargarse al menos un controlador de eventos para recibir eventos.
Sintaxis
manejador de eventos público manejador de eventos
Valores posibles
EventHandler Un objeto DPFP.Capture.EventHandler (página 65)
Esta propiedad es de solo escritura.
Clase DPFP.Capture.ReaderDescription
Proporciona información sobre un lector de huellas dactilares en particular, como su tecnología o número de serie.
Descripción del lector (GUID)
Inicializa una nueva instancia de la clase ReaderDescription mediante el GUID del dispositivo de un lector de huellas dactilares.
Sintaxis
ReaderDescription público (Guid DeviceGUID)
Parámetro
DispositivoGUID Variable que contiene un GUID de dispositivo lector de huellas dactilares
Excepción

existir.
Descripción del lector (cadena)
Inicializa una nueva instancia de la clase ReaderDescription mediante el número de serie de un lector de huellas dactilares.
Sintaxis
Descripción del lector público (String ReaderSerialNumber)
Parámetro
Excepciones

Parametro invalido Índice o número de serie El formato del número de serie especificado no es válido.

no válido
Dispositivo desconocido No se pudo acceder al dispositivo El ID de lector especificado no es válido o no
existir.
Revisión de firmware
Devuelve el número de revisión del firmware de un lector de huellas dactilares.
Sintaxis
versión de lector pública versión de firmware
Valores posibles
FirmwareRevision Variable que recibe un número de revisión de firmware del lector de huellas dactilares
HardwareRevision
Devuelve el número de revisión de hardware de un lector de huellas dactilares.
Sintaxis
Versión de lector pública Versión de hardware
Valores posibles
Versión del hardware Variable que recibe un número de revisión del hardware del lector de huellas dactilares
Idioma
Devuelve el idioma del lector de huellas dactilares.
Sintaxis
Idioma de la unidad pública
Valores posibles
Idioma Uint recibe el idioma del lector de huellas dactilares. El valor de Language siempre es 0x409, que
es inglés.
Tipo de impresión
Devuelve un valor que especifica el tipo de impresión del lector de huellas dactilares, por ejemplo, lector de deslizamiento o lector táctil
(área).
Sintaxis
público ReaderImpressionType ImpressionType
Valores posibles
Tipo de impresión Enumeración que recibe uno de los valores de DPFP.Capture.
ReaderImpressionType (página 54)
Nombre del producto
Devuelve el nombre del producto de un lector de huellas dactilares, por ejemplo, "U.are.U".
Sintaxis
nombre de producto de cadena pública
Valores posibles
Nombre del producto Cadena que recibe el nombre del producto del lector de huellas dactilares
Número de serie
Devuelve el número de serie de un lector de huellas dactilares.
Sintaxis
número de serie de cadena pública
Valores posibles
SerialNumber Cadena que recibe el número de serie del lector de huellas dactilares
Tipo de número de serie
Devuelve un valor que especifica el tipo de número de serie del lector de huellas dactilares.
Sintaxis
público ReaderSerialNumberType SerialNumberType
Valores posibles
SerialNumberType Enumeración que recibe uno de los valores de DPFP.Capture.
Tipo de número de serie (página 56)
Tecnología
Devuelve un valor que especifica la tecnología del lector de huellas dactilares.
Sintaxis
público ReaderTechnology Tecnología
Valores posibles
Tecnología Enumeración que recibe uno de los valores de DPFP.Capture.
ReaderTechnology (página 55)
Proveedor
Devuelve el nombre del proveedor de un lector de huellas dactilares, por ejemplo, "DigitalPersona, Inc."
Sintaxis
proveedor público de cadenas
Valores posibles
Proveedor Cadena que recibe el nombre del proveedor del lector de huellas dactilares
Enumeraciones Públicas
ReaderImpressionType
Define la modalidad que utiliza un lector de huellas dactilares para capturar muestras de huellas dactilares.
Sintaxis
public enum ReaderImpressionType {
Desconocido = 0,
Golpe fuerte,
Área
};
Miembros
Desconocido Un lector de huellas del que no se conoce la modalidad.
Golpe fuerte Un lector de huellas dactilares deslizante.
Área Un lector de huellas dactilares con sensor de área (táctil).
Observaciones
Los miembros de esta enumeración son utilizados por la propiedad DPFP.Capture.Capture.ImpressionType (página 52).
ReaderTecnología
Define la tecnología del lector de huellas dactilares.
Sintaxis
public enum ReaderTecnología {
Desconocido = 0,
Óptico,
capacitivo,
Térmico,
Presión
};
Miembros
Desconocido Un lector de huellas dactilares cuya tecnología no se conoce.
Óptico Un lector óptico de huellas dactilares.
Capacitivo Un lector capacitivo de huellas dactilares.
Térmico Un lector térmico de huellas dactilares.
Presión Un lector de huellas a presión.
Observaciones
Los miembros de esta enumeración son utilizados por la propiedad DPFP.Capture.Capture.Technology (página 54).
Capítulo 5: Referencia de la API Clase DPFP.Capture.ReadersCollection
Tipo de número de serie
Define si el número de serie de un lector de huellas dactilares persiste después de reiniciar.
Sintaxis
enumeración pública ReaderSerialNumberType {
persistente = 0,
Volátil
};
Miembros
Persistente Un número de serie persistente proporcionado por el hardware.
Volátil Un número de serie volátil proporcionado por el software.
Observaciones
Los miembros de esta enumeración son utilizados por la propiedad DPFP.Capture.Capture.SerialNumberType (página
53).
Clase DPFP.Capture.ReadersCollection
Proporciona información sobre todos los lectores de huellas dactilares conectados a un sistema.
Constructor público
Colección de lectores ()
Inicializa una nueva instancia de la clase ReadersCollection para enumerar todos los lectores de huellas dactilares
conectados a un sistema.
Sintaxis
colección pública de lectores()
Excepciones

Interno Error al enumerar lectores La enumeración de dispositivos falló.
Método público
Actualizar()
Borra y vuelve a enumerar un objeto ReadersCollection .
Sintaxis
actualización de vacío público ()
Excepciones

Interno Error al enumerar lectores La enumeración de dispositivos falló.
Indexadores públicos
LectorDescripción de este[Guid]
Devuelve un objeto ReaderDescription específico utilizando su GUID de dispositivo.
Sintaxis
Lector públicoDescripción de este [Guid ReaderSerialNumber]
Parámetro
ReaderSerialNumber Variable que contiene un GUID de dispositivo lector de huellas dactilares
Excepción
existir.
ReaderDescription this[int]
Devuelve un lector de huellas dactilares específico utilizando su índice.
Sintaxis
Lector público Descripción de este [índice int]
Parámetro
Índice Int que contiene un índice de lector de huellas dactilares
Excepción
Parametro invalido Índice o número de serie El índice especificado no está dentro del rango válido.

no válido
ReaderDescription this[cadena]
Devuelve un lector de huellas dactilares específico utilizando su número de serie.
Sintaxis
ReaderDescription público this[string ReaderSerialNumber]
Parámetro
Capítulo 5: Referencia de la API Clase DPFP.Capture.ReaderVersion
Excepciones
Parametro invalido Índice o número de serie El formato del número de serie especificado no es válido.

no válido
Dispositivo desconocido No se pudo acceder al dispositivo El ID de lector especificado no es válido o no
existir.
Clase DPFP.Capture.ReaderVersion
Representa información sobre la versión del lector de huellas dactilares.
Versión del lector (uint, uint, uint)
Inicializa una nueva instancia de la clase ReaderVersion para proporcionar la estructura del número de versión del lector de huellas
digitales.
Sintaxis
ReaderVersion pública (uint Build, uint Major, uint Minor)
Parámetros
Construir Uint que contiene un número de compilación
Importante Uint que contiene un número mayor
Menor Uint que contiene un número menor
Método público
Encadenar()
Convierte un objeto DPFP.Capture.ReaderVersion en una representación de cadena.
Sintaxis
cadena pública ToString()
Parámetros
Encadenar Cadena que contiene un número de versión
Capítulo 5: Referencia de la API Clase DPFP.Capture.ReaderVersion
Construir
Devuelve el número de compilación de la versión del lector de huellas dactilares.
Sintaxis
compilación de unidad pública
Valores posibles
Construir Uint que recibe el número de compilación
Importante
Devuelve el número mayor de la versión del lector de huellas dactilares.
Sintaxis
punto publico mayor
Valores posibles
Importante Uint que recibe el número mayor
Menor
Devuelve el número menor de la versión del lector de huellas dactilares.
Sintaxis
punto publico mayor
Valores posibles
Menor Uint que recibe el número menor
Capítulo 5: Referencia de la API Clase DPFP.Capture.SampleConversion
Clase DPFP.Capture.SampleConversion
Proporciona métodos para convertir una muestra de huella digital en una imagen en formato de archivo de imagen de mapa de bits o en
formato ANSI 381.
SampleConversion()
Inicializa una nueva instancia de la clase SampleConversion para convertir una muestra de huella digital en una imagen.
Sintaxis
conversión de muestra pública ()
Excepciones

Métodos públicos
ConvertToANSI381 (muestra, byte de referencia [])
Convierte una muestra de huella digital en una imagen en formato ANSI 381.
Sintaxis
byte público[] ConvertToANSI381(
Muestra Muestra, byte
de referencia[] ANSI
)
Parámetros
Muestra Un objeto DPFP.Sample (página 42)
ANSI Matriz de bytes que recibe y contiene una imagen en formato ANSI 381
Valor de retorno
Devuelve una matriz de bytes que recibe y contiene una imagen en formato ANSI 381.
Capítulo 5: Referencia de la API Clase DPFP.Capture.SampleConversion
Excepciones
Parametro invalido Parametro invalido Los argumentos proporcionados para esta función son nulos o

no contienen datos válidos.
Interno Error al exportar la imagen La conversión al formato ANSI 381 falló.

ANSI 381
ConvertToPicture (muestra, mapa de bits de referencia)
Convierte una muestra de huella digital en un formato de archivo de imagen de mapa de bits.
Sintaxis
Mapa de bits público ConvertToPicture(
Muestra Muestra, ref
Mapa de bits Mapa de bits
)
Parámetros
mapa de bits Variable que recibe y contiene una imagen en formato de archivo de mapa de bits y escala la imagen a un
tamaño de mapa de bits especificado, si se proporciona
Valor de retorno
Devuelve un mapa de bits que recibe y contiene una imagen en formato de archivo de mapa de bits.
Excepciones
Parametro invalido Parametro invalido Los argumentos proporcionados para esta función son nulos o

no contienen datos válidos.
Interno Error al exportar la imagen La conversión al formato de archivo de imagen de mapa de bits falló.

ANSI 381
Capítulo 5: Referencia de la API Enumeración DPFP.Capture.CaptureFeedback
Enumeración DPFP.Capture.CaptureFeedback
Define los valores que proporcionan información sobre una operación de captura de muestras de huellas dactilares.
Sintaxis
Enumeración pública CaptureFeedback {
Bueno = 0,
Ninguno,
Muy ligero,
Demasiado oscuro,
Demasiado ruidoso,
bajo contraste,
No hay suficientes características,
SinRegiónCentral,
sin dedo,
Demasiado alto,
Demasiado baja,
demasiado a la izquierda,
Demasiado a la derecha,
demasiado extraño,
Demasiado rapido,
demasiado sesgado,
Demasiado corto,
Demasiado lento,
Demasiado pequeña
Miembros
Bien La muestra de huellas dactilares es de calidad decente.
Ninguno Falta la muestra de la huella digital o no se recibió.
Muy ligero La muestra de huellas dactilares es demasiado clara.
Demasiado oscuro La muestra de huellas dactilares es demasiado oscura.
Demasiado ruidoso La muestra de huella dactilar es demasiado ruidosa.
bajo contraste El contraste de la muestra de huellas dactilares es demasiado bajo.
NoEnoughCaracterísticas La muestra de huellas dactilares no contiene suficiente información.
NoCentralRegion La muestra de huellas dactilares no está centrada.
Capítulo 5: Referencia de la API Enumeración DPFP.Capture.Priority
sin dedo El objeto escaneado no es un dedo.
Demasiado alto El dedo estaba demasiado alto en el sensor de deslizamiento.
Demasiado baja El dedo estaba demasiado bajo en el sensor de deslizamiento.
Demasiado a la izquierda
El dedo estaba demasiado cerca del borde izquierdo del sensor de deslizamiento.
Demasiado a la derecha El dedo estaba demasiado cerca del borde derecho del sensor de deslizamiento.
demasiado extraño El escaneo se ve extraño.
Demasiado rapido El dedo se pasó demasiado rápido.
Demasiado sesgado La muestra de huellas dactilares está demasiado sesgada.
Demasiado corto La muestra de huellas dactilares es demasiado corta.
Demasiado lento El dedo se pasó demasiado despacio.
Demasiado pequeña El tamaño de la muestra de huellas dactilares es demasiado pequeño.
Observaciones
Los miembros de esta enumeración son utilizados por el método DPFP.Processing.CreateFeatureSet (página 83) y por el evento OnSampleQuality del controlador de
eventos de captura de muestras de huellas digitales (página 68).
Enumeración DPFP.Capture.Priority
Define la prioridad de una operación de captura de muestras de huellas dactilares realizada por un lector de huellas dactilares.
Sintaxis
prioridad de enumeración pública {
Bajo = 0,
Normal,
Alto };
Capítulo 5: Referencia de la API Interfaz DPFP.Capture.EventHandler
Miembros
Bajo Baja prioridad. Una aplicación usa esta prioridad para adquirir eventos del lector de huellas
dactilares solo si no hay suscriptores con prioridad alta o normal. Solo se permite un suscriptor con
esta prioridad.
Normal Prioridad normal. Una aplicación usa esta prioridad para adquirir eventos del lector de huellas
digitales solo si la operación se ejecuta en un proceso de primer plano. Se permiten múltiples
suscriptores con esta prioridad.
Alto Alta prioridad. (RESERVADO. Solo para uso interno). Un suscriptor usa esta prioridad para
adquirir eventos del lector de huellas dactilares exclusivamente. Solo se permite un suscriptor
con esta prioridad. Tenga en cuenta que en Windows Vista y versiones posteriores, el suscriptor
debe ser la cuenta del sistema o un miembro del grupo de administradores.
Observaciones
Los miembros de esta enumeración son utilizados por la propiedad DPFP.Capture.Priority (página 49).
Interfaz DPFP.Capture.EventHandler
Define los eventos de la operación de captura de muestras de huellas dactilares.
Sintaxis
controlador de eventos de interfaz pública {
void OnComplete(Objeto, Cadena, Muestra); void
OnFingerGone(Objeto, Cadena); void OnFingerTouch
(Objeto, Cadena); void OnReaderConnect(Objeto,
Cadena); void OnReaderDisconnect(Objeto, Cadena); void
OnSampleQuality(Object, String, CaptureFeedback);
Eventos
OnComplete(Objeto, Cadena, Muestra)
Se activa cuando un lector de huellas dactilares captura correctamente una muestra de huellas dactilares.
Sintaxis
public void OnComplete (Captura de objetos,
Número de serie del lector de cadenas,
Muestra Muestra);
DigitalPersona One Touch para Windows SDK: Edición .NET | Guía del desarrollador sesenta y cinco
Parámetros
Captura Un objeto DPFP.Capture.Capture (página 46)
ReaderSerialNumber Cadena que contiene el ID del lector de huellas dactilares del que se capturó
la muestra de huellas dactilares
OnFingerGone(Objeto, Cadena)
Se activa cuando un usuario quita un dedo de un lector de huellas dactilares.
Sintaxis
vacío público OnFingerGone (
captura de objetos,
Cadena ReaderSerialNumber );
Parámetros
ReaderSerialNumber Si se utilizó Capture(Priority) o Capture() para inicializar una instancia de la
clase Capture , este parámetro es una cadena que contiene un ID de lector
vacío, es decir, todos ceros.
Si se usó Capture(String, Priority) o Capture(String) para inicializar una
instancia de la clase Capture , este parámetro es una cadena que contiene
el número de serie del lector de huellas dactilares especificado.
OnFingerTouch(Objeto, Cadena)
Se dispara cuando un usuario toca un lector de huellas dactilares.
Sintaxis
vacío público OnFingerTouch (
captura de objetos,
Parámetros
ReaderSerialNumber Si se utilizó Capture(Priority) o Capture() para inicializar una instancia de la
clase Capture , este parámetro es una cadena que contiene un ID de lector
vacío, es decir, todos ceros.
Si se usó Capture(String, Priority) o Capture(String) para inicializar una
instancia de la clase Capture , este parámetro es una cadena que contiene
el número de serie del lector de huellas dactilares especificado.
OnReaderConnect(Objeto, Cadena)
Se activa cuando se conecta un lector de huellas dactilares a un sistema.
Sintaxis
vacío público OnReaderConnect (
captura de objetos,
Parámetros
OnReaderDisconnect(Objeto, Cadena)
Se dispara cuando un lector de huellas dactilares se desconecta de un sistema.
Sintaxis
vacío público OnReaderDisconnect(
captura de objetos,
Parámetros
Capítulo 5: Referencia de la API bibliotecas
OnSampleQuality(Objeto, Cadena, CaptureFeedback)
Se activa cuando se verifica la calidad de una muestra de huellas dactilares.
Sintaxis
public void OnSampleQuality(
captura de objetos,
Número de serie del lector de cadenas,
Capturar comentarios Capturar comentarios);
Parámetros
ReaderSerialNumber Cadena que contiene el ID del lector de huellas dactilares del que se capturó la
muestra de huellas dactilares
Capturar comentarios Enumeración que especifica uno de los valores de DPFP.Capture.
CaptureFeedback (página 63)
bibliotecas
DPFPShrNet.dll para la enumeración DPFP.Capture.CaptureFeedback
DPFPDevNet.dll para todos los demás miembros del espacio de nombres DPFP.Capture
Capítulo 5: Referencia de la API GUI Component
GUI Component
El componente GUI está envuelto dentro del espacio de nombres DPFP.Gui , que proporciona interfaces gráficas de usuario
para realizar operaciones de registro y verificación de huellas digitales y una enumeración del estado del controlador de
eventos. Los siguientes dos espacios de nombres están envueltos dentro del espacio de nombres DPFP.Gui :
Inscripción: este espacio de nombres se define en Espacio de nombres de inscripción en la página 70.
Verificación: este espacio de nombres se define en Espacio de nombres de verificación en la página 80.
EventHandlerStatus
Define los códigos que devuelven el control de inscripción de huellas dactilares y los controladores de eventos de control de
verificación de huellas dactilares para indicar el estado de una operación.
Sintaxis
enumeración pública EventHandlerStatus {
Éxito = 0,
Fracaso = 1
};
Miembros
Éxito Una operación se realizó con éxito.
Falla Una operación falló.
Observaciones
Los miembros de esta enumeración son utilizados por los eventos OnDelete y OnEnroll (página 75) del controlador de
eventos de control de registro de huellas digitales y por el evento OnComplete del controlador de eventos de
control de verificación de huellas digitales (página 82).
Biblioteca
DPFPGuiNet.dll
Capítulo 5: Referencia de la API Espacio de nombres de inscripción
Espacio de nombres de inscripción
Los miembros del espacio de nombres DPFP.Gui.Enrollment incluyen un control .NET que implementa una interfaz gráfica de
usuario (descrita en Interfaz gráfica de usuario DPFP.Gui.Enrollment en la página 94) y proporciona la siguiente funcionalidad:
Captura muestras de huellas dactilares de un lector de huellas dactilares
Crea conjuntos de características de huellas dactilares con el propósito de inscripción
Crea plantillas de huellas digitales
Notifica a una aplicación cuando un afiliado se compromete a eliminar una plantilla de huella digital
Eventos de incendios
Clase DPFP.Gui.Enrollment.EnrollmentControl
Proporciona un control .NET que se utiliza para realizar operaciones de registro de huellas dactilares.
Control de inscripción()
Inicializa una nueva instancia de la clase EnrollmentControl que proporciona un control .NET para realizar operaciones de inscripción de
huellas digitales.
Sintaxis
Control de inscripción público ()
EnrolledFingerMascara
Devuelve o asigna la máscara que representa las huellas dactilares registradas del usuario. La máscara de inscripción es una
combinación de los valores que representan las huellas dactilares registradas de un usuario. Por ejemplo, si se registran la huella
dactilar índice derecha y la huella dactilar media derecha de un usuario, el valor de esta propiedad es 00000000 011000000 o 192.
Sintaxis
público int EnrolledFingerMask
Valores posibles
EnrolledFingerMascara Int que recibe o asigna el valor de la máscara de la huella. Todos los valores posibles se
enumeran en la Tabla 4.
Capítulo 5: Referencia de la API Clase DPFP.Gui.Enrollment.EnrollmentControl
Tabla 4. Valores de la máscara de inscripción
Dedo Representación binaria Representación entera
dedo meñique izquierdo 000000000 000000001 1
dedo anular izquierdo 000000000 000000010 2
dedo medio izquierdo 000000000 000000100 4
dedo índice izquierdo 000000000 000001000 8
Pulgar izquierdo 000000000 000010000 dieciséis
Pulgar derecho 000000000 000100000 32
dedo índice derecho 000000000 001000000 64
dedo medio derecho 000000000 010000000 128
dedo anular derecho 000000000 100000000 256
dedo meñique derecho 000000001 000000000 512
Esta propiedad opcional es de lectura/escritura. Si no lo establece, se utiliza el valor 0 , lo que significa que no se han registrado
huellas dactilares.
Carga un controlador de eventos de control de inscripción de huellas dactilares. Establezca esta propiedad en nulo para borrar todos los controladores de
eventos registrados.
Sintaxis
Valores posibles
EventHandler Un objeto DPFP.Gui.Enrollment.EventHandler (página 73)
Capítulo 5: Referencia de la API Clase DPFP.Gui.Enrollment.EnrollmentControl
MaxEnrollFingerCount
Devuelve o asigna el valor de la cantidad máxima de huellas dactilares que se pueden registrar.
Sintaxis
público int MaxEnrollFingerCount
Valores posibles
MaxEnrollFingerCount Int que recibe o asigna el valor para el número máximo de
huellas dactilares que se pueden registrar. Los valores posibles son del 1 al 10.
Esta propiedad opcional es de lectura/escritura. Si no lo configura, se usa el valor 10 , lo que significa que el usuario puede
registrar las diez huellas dactilares.
ReaderSerialNumber
Devuelve o asigna el número de serie del lector de huellas dactilares del que se captura una muestra de huellas dactilares.
Sintaxis
Cadena pública Número de serie del lector
Valores posibles
ReaderSerialNumber Cadena que recibe o asigna un número de serie del lector de huellas dactilares
Esta propiedad opcional es de lectura/escritura. Si no lo establece, se utiliza el siguiente valor:
{00000000000000000000000000000000}. Esto significa que la aplicación recibirá eventos de cualquiera de los lectores de
huellas dactilares conectados al sistema.
Capítulo 5: Referencia de la API Interfaz DPFP.Gui.Enrollment.EventHandler
Interfaz DPFP.Gui.Enrollment.EventHandler
Define los eventos de control de registro de huellas dactilares.
Sintaxis
void OnDelete(Object, int, ref Gui.EventHandlerStatus); void OnEnroll(Object, int,
Template, ref Gui.EventHandlerStatus); void OnFingerTouch (Objeto, Cadena, int); void
OnFingerRemove(Objeto, Cadena, int); void OnComplete(Objeto,
Cadena, int); void OnReaderConnect(Objeto, Cadena, int); void
OnReaderDisconnect(Objeto, Cadena, int); void
OnSampleQuality(Object, String, int, Capture.CaptureFeedback);
void OnStartEnroll(Objeto, Cadena, int); void OnCancelEnroll(Objeto,
Cadena, int);
Eventos
OnCancelEnroll(Objeto, Cadena, int)
Se dispara cuando se cancela la inscripción.
Sintaxis
public void OnCancelEnroll(
control de objetos,
String ReaderSerialNumber, int Finger );
Parámetros
Control Un objeto DPFP.Gui.Enrollment.EnrollmentControl (página 70).
ReaderSerialNumber Número de serie del lector de huellas dactilares utilizado para el registro.
Dedo Int que contiene el valor de índice para la huella dactilar inscrita. Para conocer los valores
posibles, consulte la Tabla 5 (página 74).
El parámetro Finger es el valor de índice del dedo asociado con una huella digital que se registrará o una plantilla de
huella digital que se eliminará, como se define en ANSI/NISTITL 1. Los valores de índice se asignan al
representación gráfica de los dedos de las manos en la interfaz gráfica de usuario. Todos los valores posibles se
enumeran en la Tabla 5.
Tabla 5. Valores del índice de los dedos en ANSI/NISTITL 1
Dedo Dedo de valor índice Valor de índice
Pulgar derecho 1 Pulgar izquierdo 6
dedo índice derecho 2 dedo índice izquierdo 7
dedo medio derecho 3 dedo medio izquierdo 8
dedo anular derecho 4 dedo anular izquierdo 9
dedo meñique derecho 5 dedo meñique izquierdo 10
OnComplete(Objeto, Cadena, int)
Se activa cuando un lector de huellas dactilares captura correctamente una muestra de huellas dactilares.
Sintaxis
public void OnComplete(
control de objetos,
Parámetros
F
OnDelete(Objeto, int, ref Gui.EventHandlerStatus)
Se activa cuando un usuario se compromete a eliminar una huella digital registrada. La aplicación gestiona la eliminación de la plantilla
de huellas dactilares de un subsistema de almacenamiento de datos de huellas dactilares y puede mostrar sus propios mensajes de
éxito o error.
Sintaxis
public void OnDelete( Control de
objetos, int Finger, ref
Gui.EventHandlerStatus EventHandlerStatus
);
Parámetros
Control Un objeto DPFP.Gui.Enrollment.EnrollmentControl (página 70)
Dedo Int que contiene el valor de índice de la huella digital (registrada) que se eliminará.
Para conocer los valores posibles, consulte la Tabla 5 (página 74).
EventHandlerStatus Enumeración que recibe y contiene uno de los valores de
DPFP.Gui.EventHandlerStatus, que establece el controlador de
eventos, si es necesario (página 69).
OnEnroll(Objeto, int, Plantilla, ref Gui.EventHandlerStatus)
Se activa cuando un usuario registra una huella digital y devuelve una plantilla de huella digital. La aplicación maneja el almacenamiento de la
plantilla de huellas dactilares en un subsistema de almacenamiento de datos de huellas dactilares y puede mostrar sus propios mensajes
de éxito o error.
Sintaxis
public void OnEnroll(Control de
objetos, dedo int,
plantilla de
plantilla, ref
);
Parámetros
Control Un objeto DPFP.Gui.Enrollment.EnrollmentControl (página 70)
Plantilla Un objeto DPFP.Template (página 43)
DPFP.Gui.EventHandlerStatus (página 69)
OnFingerRemove(Objeto, Cadena, int)
Se activa cuando un usuario quita el dedo de un lector de huellas dactilares.
Sintaxis
vacío público OnFingerRemove (
control de objetos,
Parámetros
OnFingerTouch(Objeto, Cadena, int)
Se dispara cuando un usuario toca un lector de huellas dactilares.
Sintaxis
vacío público OnFingerRemove (
control de objetos,
Parámetros
OnReaderConnect(Objeto, Cadena, int)
Se dispara cuando se conecta un lector de huellas dactilares.
Sintaxis
vacío público OnReaderConnect (
control de objetos,
Parámetros
OnReaderDisconnect(Objeto, Cadena, int)
Se dispara cuando se desconecta un lector de huellas dactilares.
Sintaxis
vacío público OnReaderDisconnect(
control de objetos,
Parámetros
OnSampleQuality(Objeto, Cadena, int, Capture.CaptureFeedback)
Se activa cuando se verifica la calidad de una muestra del lector de huellas dactilares.
Sintaxis
public void OnSampleQuality(Control de
objetos, String
ReaderSerialNumber, int Finger,
Capture.CaptureFeedback CaptureFeedback);
Parámetros
Capturar comentarios Calidad de la muestra capturada.
OnStartEnroll(Objeto, Cadena, int)
Se dispara cuando ha comenzado la inscripción.
Sintaxis
public void OnStartEnroll(
control de objetos,
Parámetros
Biblioteca
DPFPGuiNet.dll
Capítulo 5: Referencia de la API Espacio de nombres de verificación
Espacio de nombres de verificación
El componente de control de usuario de verificación está envuelto dentro del espacio de nombres DPFP.Gui.Verification .
Los miembros de este componente incluyen un control .NET que implementa una interfaz gráfica de usuario (descrita en DPFP.Gui.Verification Interfaz
gráfica de usuario en la página 103) y proporciona la siguiente funcionalidad:
Recibe notificaciones de eventos de conexión y desconexión del lector de huellas dactilares
Captura muestras de huellas dactilares de un lector de huellas dactilares
Crea conjuntos de características de huellas dactilares con el propósito de verificación
Dispara un evento
Clase DPFP.Gui.Verification.VerificationControl
Proporciona un control .NET que se utiliza para realizar operaciones de verificación de huellas dactilares.
VerificaciónControl()
Inicializa una nueva instancia de la clase VerificationControl que proporciona un control .NET para realizar la verificación de huellas digitales.
Sintaxis
control de verificación pública ()
Activo
Controla el estado de captura de huellas dactilares.
Sintaxis
público bool activo
Valores posibles
Verdadero Permite la captura de huellas dactilares.
FALSO Desactiva la captura de huellas dactilares.
Capítulo 5: Referencia de la API Interfaz DPFP.Gui.Verification.EventHandler
Carga un controlador de eventos de control de verificación de huellas dactilares. Establezca esta propiedad en nulo para borrar todos los controladores de
eventos registrados.
Sintaxis
Valores posibles
EventHandler Un objeto DPFP.Gui.Verification.EventHandler (página 81)
ReaderSerialNumber
Devuelve o asigna el número de serie del lector de huellas dactilares del que se captura una muestra de huellas dactilares.
Sintaxis
Cadena pública Número de serie del lector
Valores posibles
ReaderSerialNumber Cadena que recibe o contiene un número de serie del lector de huellas dactilares
Esta propiedad opcional es de lectura/escritura. Si no lo establece, se utiliza el siguiente valor:
{00000000000000000000000000000000}. Esto significa que la aplicación recibirá eventos de cualquiera de los lectores de
huellas dactilares conectados al sistema.
Interfaz DPFP.Gui.Verification.EventHandler
Define los eventos de control de verificación de huellas dactilares.
Sintaxis
void OnComplete(Object, FeatureSet, ref Gui.EventHandlerStatus);
}
Evento
OnComplete(Object, FeatureSet, ref Gui.EventHandlerStatus)
Se activa cuando un conjunto de funciones de huellas dactilares creado con el propósito de verificación está listo para la comparación y devuelve el
conjunto de funciones de huellas dactilares. La aplicación maneja la comparación del conjunto de funciones de huellas dactilares con una
plantilla de huellas dactilares.
Sintaxis
public void OnComplete( Control de
objetos, FeatureSet
FeatureSet, ref
);
Parámetros
Control Un objeto DPFP.Gui.Verification.VerificationControl (página 80)
Conjunto de características Un objeto DPFP.FeatureSet (página 41)
DPFP.Gui.EventHandlerStatus, que establece el controlador de eventos de
control de verificación de huellas digitales, si es necesario (página 69)
Biblioteca
DPFPGuiNet.dll
Capítulo 5: Referencia de la API Componente de procesamiento
Componente de procesamiento
El componente de procesamiento está envuelto dentro del espacio de nombres DPFP.Processing . Los miembros de este componente proporcionan
métodos y propiedades para
Crear conjuntos de funciones de huellas dactilares con el propósito de inscripción o verificación
Realización de la función del sistema de registro de huellas dactilares mediante la creación de plantillas de huellas dactilares
Clase DPFP.Processing.FeatureExtraction
Realiza la extracción de características de huellas dactilares. Los miembros de la clase FeatureExtraction crean un conjunto de características de huellas
dactilares con el propósito de inscripción o verificación aplicando la extracción de características de huellas dactilares a una muestra de huellas
dactilares.
Extracción de características()
Inicializa una nueva instancia de la clase FeatureExtraction para crear conjuntos de funciones de huellas dactilares.
Sintaxis
Extracción pública de funciones ()
Excepción

Interno No se pudo crear el contexto El SDK no pudo crear un identificador para el procesamiento,

posiblemente debido a una mala configuración, archivos
binarios incompatibles o limitaciones de seguridad/memoria.
Método público
CreateFeatureSet(Muestra, DataPurpose, ref CaptureFeedback, ref FeatureSet)
Aplica la extracción de funciones de huellas dactilares a una muestra de huellas dactilares y luego crea un conjunto de funciones de huellas dactilares para
el propósito especificado.
Capítulo 5: Referencia de la API Clase DPFP.Processing.FeatureExtraction
Sintaxis
public void CreateFeatureSet(
muestra muestra,
DataPurpose Propósito, ref
CaptureFeedback CaptureFeedback, ref FeatureSet
FeatureSet
)
Parámetros
Muestra de huellas dactilares Un objeto DPFP.Sample (página 42)
Objetivo Enumeración que contiene uno de los valores de DPFP.Processing.
Propósito de datos (página 88)
Capturar comentarios Enumeración que recibe y contiene uno de los valores de
DPFP.Capture.CaptureFeedback (página 63)
Excepción
Conjunto de funciones no válido La extracción del conjunto de funciones falló La extracción del conjunto de funciones de huellas dactilares falló porque el
la muestra de huellas dactilares está corrupta o no contiene características.
Para obtener información específica, verifique el valor del
parámetro CaptureFeedback .
Tipo de conjunto de características no válido Propósito de conjunto de funciones no válido El propósito del conjunto de funciones de huellas dactilares es incompatible.
Parametro invalido Parametro invalido Los argumentos proporcionados para esta función son nulos o no contienen

datos válidos.
Interno La extracción del conjunto de características falló La extracción del conjunto de características de la huella digital falló, posiblemente debido a
limitaciones de memoria o seguridad.
Capítulo 5: Referencia de la API DPFP.Procesamiento.Clase de inscripción
DPFP.Procesamiento.Clase de inscripción
Realiza la función del sistema de registro de huellas dactilares. Los miembros de la clase Inscripción crean una plantilla de huellas
dactilares a partir de un número específico de conjuntos de funciones de huellas dactilares que se crearon con el fin de la inscripción.
Inscripción()
Inicializa una nueva instancia de la clase Inscripción para realizar la función del sistema de inscripción de huellas dactilares.
Sintaxis
Inscripción pública()
Excepción


Métodos públicos
Agregar características (Conjunto de características)
Agrega conjuntos de funciones de huellas dactilares, uno por uno, a una plantilla de huellas dactilares. La plantilla de huella digital está
completa cuando la propiedad TemplateStatus se establece en el valor Listo.
Sintaxis
Public void AddFeatures(
Conjunto de funciones Conjunto de funciones
Parámetro
Excepción
No inicializado No se pudo inicializar El SDK no se pudo inicializar correctamente, posiblemente debido a

una mala configuración, archivos binarios incompatibles o limitaciones
de seguridad/memoria.
Parametro invalido Parametro invalido Los argumentos proporcionados para esta función son nulos o no contienen

datos válidos.
Conjunto de funciones no válido El procedimiento de inscripción No se pudo registrar la huella digital. Los conjuntos de funciones de

falló huellas dactilares suministrados son insuficientes o incompatibles.
Interno El procedimiento de inscripción Falló el registro de huellas dactilares, posiblemente debido a limitaciones

falló de memoria o seguridad.
Claro()
Borra una plantilla de huellas digitales y establece el valor de la propiedad TemplateStatus en Desconocido para que una aplicación pueda
comenzar otra operación de creación de plantillas de huellas digitales.
Sintaxis
vacío público Borrar ()
Características Necesario
Devuelve la cantidad de conjuntos de funciones de huellas dactilares que aún se necesitan para crear una plantilla de huellas dactilares.
Cuando el valor de FeaturesNeeded es igual a 0, se crea la plantilla de huella digital.
Sintaxis
public uint FeaturesNeeded
Valores posibles
Características Necesario Uint que recibe el valor del número de conjuntos de funciones de huellas dactilares
Plantilla
Devuelve un objeto DPFP.Template creado durante una operación de registro de huellas dactilares.
IMPORTANTE: La aplicación debe verificar la propiedad TemplateStatus antes de leer esta propiedad.
Sintaxis
Plantilla pública Plantilla
Valores posibles
Excepción
Parametro invalido Inscripción incompleta La plantilla de huella digital no está lista para ser recuperada.

Compruebe la propiedad TemplateStatus antes de leer
esta propiedad.
Estado de la plantilla
Devuelve un valor que especifica el estado de una operación de creación de plantilla de huella digital.
Sintaxis
Estado público TemplateStatus
Valores posibles
Estado de la plantilla Enumeración que recibe uno de los valores de DPFP.Processing.
Inscripción.Estado (página 88)
Capítulo 5: Referencia de la API Enumeración DPFP.Processing.DataPurpose
Estado
Define el estado de una operación de creación de plantilla de huella digital.
Sintaxis
enumeración pública Estado
{
Desconocido = 0,
Insuficiente,
Fallido,
Listo
}
Miembros
Desconocido Se desconoce el estado de una operación de creación de plantilla, probablemente porque
todavía no existe una plantilla de huellas dactilares.
Insuficiente Existe una plantilla de huellas dactilares, pero se requieren más conjuntos de funciones de huellas dactilares
para completarla.
Fallido Falló una operación de creación de plantilla de huella digital.
Listo Se creó una plantilla de huellas dactilares y está lista para usar.
Observaciones
Los miembros de esta enumeración son utilizados por la propiedad DPFP.Capture.TemplateStatus (página 87).
Enumeración DPFP.Processing.DataPurpose
Define el propósito para el que se utilizará un conjunto de funciones de huellas dactilares.
Sintaxis
enumeración pública DataPurpose {
Desconocido = 0,
Verificación,
Inscripción
};
Capítulo 5: Referencia de la API bibliotecas
Miembros
Desconocido No se conoce el propósito.
Verificación Una función de huella digital configurada para ser utilizada con fines de verificación.
Inscripción Una función de huellas dactilares configurada para ser utilizada con el propósito de inscripción.
Observaciones
Los miembros de esta enumeración son utilizados por DPFP.Processing.FeatureExtraction.
Método CreateFeatureSet (página 83).
bibliotecas
DPFPShrNet.dll para la enumeración DPFP.Processing.DataPurpose
DPFPEngNet.dll para todos los demás miembros del espacio de nombres DPFP.Processing
Capítulo 5: Referencia de la API Componente de verificación
Componente de verificación
El componente de verificación está envuelto dentro del espacio de nombres DPFP.Verification . Los miembros de este componente
proporcionan un método y propiedades para
Realización de la función del sistema de verificación de huellas dactilares
Devolución y recuperación de la tasa de aceptación falsa (FAR)
Devolver los resultados de la operación de verificación de huellas dactilares
DPFP.Verification.Verification Class
Realiza la función del sistema de verificación de huellas dactilares, que es una comparación uno a uno de un conjunto de funciones
de huellas dactilares con una plantilla de huellas dactilares producida en el registro que arroja una decisión de coincidencia o no coincidencia.
Verificación()
Inicializa una nueva instancia de la clase de verificación para comparar un conjunto de funciones de huellas dactilares con una
plantilla de huellas dactilares utilizando el valor predeterminado de la tasa de aceptación falsa (FAR). (Para obtener más información sobre
FAR, consulte Falsos positivos y falsos negativos en la página 20).
Sintaxis
Verificación pública()
Excepción


Verificación (int)
Inicializa una nueva instancia de la clase de verificación para comparar un conjunto de características de huellas dactilares con
una plantilla de huellas dactilares y asigna el valor de FAR. (Para obtener más información sobre FAR, consulte Falsos positivos y falsos
negativos en la página 20).
Capítulo 5: Referencia de la API DPFP.Verification.Verification Class
IMPORTANTE: aunque el valor predeterminado es adecuado para la mayoría de las aplicaciones, es posible que necesite un valor inferior o
mayor valor para satisfacer sus necesidades. Si decide utilizar un valor que no sea el predeterminado, asegúrese
de comprender las consecuencias de hacerlo. Consulte el Apéndice A en la página 111 para obtener
más información sobre cómo configurar el valor de FAR.
Sintaxis
Verificación pública (int FARRequested)
Parámetro
FARSolicitado Int que contiene el valor del FAR solicitado
Excepción


Método
Verificar (Conjunto de funciones, Plantilla, Resultado de referencia)
Realiza la función del sistema de verificación de huellas dactilares y especifica una decisión de comparación basada en el FAR
establecido por la propiedad FARRequested .
Sintaxis
vacío público Verificar (
Conjunto de funciones Conjunto de funciones,
Plantilla Plantilla, ref Resultado
Resultado
)
Capítulo 5: Referencia de la API DPFP.Verification.Verification Class
Parámetros
Conjunto de características Un objeto DPFP.FeatureSet , donde el parámetro Propósito del método
DPFP.Processing.FeatureExtraction.CreateFeatureSet se estableció en el valor Verificación
(página 83)
Resultado Un objeto DPFP.Verification.Result (página 93)
Excepción
Parametro invalido Parametro invalido Los argumentos proporcionados para esta función son nulos o no

contienen datos válidos.
Conjunto de funciones no válido Fallo de verificación La verificación de la huella dactilar falló. El conjunto de funciones de

huellas dactilares o la plantilla de errores proporcionados son
insuficientes o incompatibles.
Interno Fallo de verificación La verificación de huellas dactilares falló, posiblemente debido a

limitaciones de memoria/seguridad.
Propiedades
FARSolicitado
Devuelve o asigna la tasa de aceptación falsa (FAR) solicitada. (Para obtener más información sobre FAR, consulte Falsos positivos
y falsos negativos en la página 20).
IMPORTANTE: aunque el valor predeterminado es adecuado para la mayoría de las aplicaciones, es posible que necesite un valor inferior o
mayor valor para satisfacer sus necesidades. Si decide utilizar un valor que no sea el predeterminado, asegúrese
de comprender las consecuencias de hacerlo. Consulte el Apéndice A en la página 111 para obtener más
información sobre cómo configurar el valor de FAR.
Sintaxis
public int FARRequested
Valores posibles
FARSolicitado Int que recibe o asigna el valor de la FAR solicitada
Esta propiedad opcional es de lectura/escritura. Puede usar la propiedad FARRequested para verificar o modificar el valor
de FAR antes de llamar al método Verify . Si no establece esta propiedad, se utiliza el valor predeterminado.
Capítulo 5: Referencia de la API DPFP.Verificación.Clase de resultado
DPFP.Verificación.Clase de resultado
Representa los resultados de una operación de verificación de huellas dactilares.
Constructor predeterminado
El objeto DPFP.Verification.Result se proporciona en el parámetro Result del método Verify (página 91). La construcción
predeterminada establece la propiedad FARAchieved en 0 y la propiedad Verified en falso.
Propiedades
FARAlogrado
Devuelve o asigna el valor de la FAR alcanzada para una operación de comparación.
Sintaxis
public int FARAlogrado
Valores posibles
FARAlogrado Int que recibe o asigna el valor de la FAR que se logró para la comparación
Esta propiedad es de lectura/escritura. Consulte FAR logrado en la página 113 para obtener más información sobre esta propiedad.
Verificado
Devuelve o asigna la decisión de comparación, que indica si la comparación de un conjunto de funciones de huellas dactilares y una
plantilla de huella dactilar resultó en una decisión de coincidencia o no coincidencia. Esta decisión se basa en el valor de la propiedad
FARRequested (página 92).
Sintaxis
público bool Verificado
Valores posibles
Verificado Booleano que recibe o asigna la decisión de comparación. Los valores posibles son verdaderos para
una decisión de coincidencia o falsos para una decisión de no coincidencia.
Esta propiedad es de lectura/escritura.
Biblioteca
DPFPVerNet.dll
Interfaces gráficas de usuario 6
Este capítulo describe la funcionalidad de las interfaces gráficas de usuario que se incluyen en los siguientes espacios de nombres:
DPFP.Gui.Inscripción
Este espacio de nombres incluye la interfaz gráfica de usuario que se describe en la siguiente sección. El constructor, las
propiedades y el controlador de eventos contenidos en este espacio de nombres se describen en la página 70.
DPFP.Gui.Verificación
Este objeto incluye la interfaz gráfica de usuario descrita en la página 103. El constructor, las propiedades y el controlador de
eventos contenidos en este espacio de nombres se describen en la página 80.
Interfaz gráfica de usuario DPFP.Gui.Enrollment
La interfaz gráfica de usuario incluida con el objeto DPFP.Gui.Enrollment.EnrollmentControl consta de dos elementos. El primer
elemento se usa para proporcionar instrucciones para seleccionar una huella digital para registrar o cancelar (eliminar) y se usa para
indicar huellas digitales ya registradas. El segundo elemento se utiliza para proporcionar instrucciones y comentarios, tanto de forma
gráfica como textual, sobre el proceso de inscripción.
Las tablas y la figura de esta sección describen la interacción entre el usuario y la interfaz gráfica de usuario durante el registro y
cancelación del registro (eliminación) de huellas dactilares.
NOTA: En las tablas, los elementos se denominan elemento de manos y elemento de números.
Registro de una huella digital
La figura 9 ilustra el proceso de registro de huellas dactilares utilizando DPFP.Gui.Enrollment.
Interfaz gráfica de usuario del objeto EnrollmentControl . Los números de imagen de la figura corresponden a las imágenes de la
Tabla 6 en la página 96. La Tabla 6 ilustra y describe la interacción entre el usuario y la interfaz gráfica de usuario durante el
registro de huellas dactilares.
Capítulo 6: Interfaces gráficas de usuario Registro de una huella digital
Figura 9. Registro de una huella digital mediante DPFP.Gui.Enrollment.
Interfaz gráfica de usuario del objeto EnrollmentControl
Tabla 6. Interfaz gráfica de usuario del objeto DPFP.Gui.Enrollment.EnrollmentControl: inscripción de un
huella dactilar
Interfaz gráfica del usuario Acciones del usuario y retroalimentación de la interfaz de usuario
Imagen 1 Esta imagen indica que no se han registrado huellas dactilares,
porque los dedos asociados con las huellas dactilares registradas son
verdes.
Imagen 2 El usuario hizo clic en el dedo índice derecho y el control pasó del
elemento de manos al elemento de números.
El elemento de números está listo para registrar la huella dactilar
índice derecha del usuario, como lo indica el dedo verde de la mano
en la esquina inferior izquierda.
Imagen 3 El usuario tocó el lector de huellas dactilares y se creó un conjunto de
funciones de huellas dactilares.
Tabla 6. Interfaz gráfica de usuario del objeto DPFP.Gui.Enrollment.EnrollmentControl : inscripción de una huella digital (continuación)
Imagen 4A El usuario tocó el lector de huellas dactilares, pero no se creó un conjunto de
funciones de huellas dactilares. El mensaje que se muestra depende de la calidad de
la muestra de la huella digital, como se muestra en las Imágenes 4A y 4B.
Imagen 4B
Imagen 5 El usuario tocó el lector de huellas dactilares y se creó un segundo conjunto de
funciones de huellas dactilares.
Imagen 6 El usuario tocó el lector de huellas dactilares y se creó un tercer
conjunto de funciones de huellas dactilares.
Imagen 7 El usuario tocó el lector de huellas dactilares y se creó un cuarto
conjunto de funciones de huellas dactilares.
Imagen 8 Cuando se crea una plantilla de huella digital para el dedo
seleccionado, el control pasa al elemento de manos.
Esta imagen aparece cuando se activa el evento OnEnroll del
controlador de eventos de control de inscripción y devuelve un
estado de Éxito en el parámetro EventHandlerStatus .
Imagen 9 El elemento de las manos indica que la huella digital del índice
derecho está registrada, es decir, el dedo es verde.
El valor de la propiedad EnrolledFingerMask es 000000000 001000000 o
64.
Imagen 10 No se creó una plantilla de huella digital para el dedo seleccionado.
Se indica al usuario que vuelva a intentarlo y el control permanece con el
elemento de números.
Imagen 11 Este mensaje aparece cuando el usuario hace clic aquí en Haga clic aquí
para cancelar la inscripción. Cuando el usuario hace clic en No, este mensaje
se descarta y el control vuelve al elemento de números. Cuando el
usuario hace clic en Sí, este mensaje se descarta y el control pasa al
elemento manos.
El usuario puede cancelar la inscripción en cualquier momento haciendo
clic aquí y luego haciendo clic en Sí.
Imagen 12 Este mensaje se muestra cuando un usuario que ya registró el
número máximo permitido de huellas dactilares (establecido por
la propiedad MaxEnrollFingerCount ) hace clic en un dedo asociado
con un dedo no registrado en el elemento manos. Cuando el
usuario hace clic en Aceptar, el control vuelve al elemento manos.
Capítulo 6: Interfaces gráficas de usuario Cancelación de la inscripción (eliminación) de una huella digital
Cancelación de la inscripción (eliminación) de una huella digital
La siguiente tabla ilustra y describe la interacción entre el usuario y la interfaz gráfica de usuario durante la cancelación del
registro de huellas dactilares (eliminación).
Tabla 7. Interfaz gráfica de usuario de DPFP.Gui.Enrollment.EnrollmentControl : cancelación de la inscripción
(eliminación) de una plantilla de huella digital
El elemento de las manos indica que la huella digital del
índice derecho está registrada, es decir, el dedo es verde.
El valor de la propiedad EnrolledFingerMask es 000000000
001000000 o 64.
Este mensaje aparece cuando el usuario hace clic en la huella
dactilar índice derecha (que se registró previamente).
Cuando el usuario hace clic en No, este mensaje se descarta y
el control vuelve al elemento manos, que permanece sin cambios.
Cuando el usuario hace clic en Sí, este mensaje se descarta y el
control vuelve al elemento manos, donde se muestra el
mensaje Huella digital eliminada (ver la siguiente imagen).
Capítulo 6: Interfaces gráficas de usuario Cancelación de la inscripción (eliminación) de una huella digital
Tabla 7. Interfaz gráfica de usuario de DPFP.Gui.Enrollment.EnrollmentControl: cancelar la inscripción
(borrar) una plantilla de huella digital (continuación)
Esta imagen aparece cuando se activa el evento OnDelete del
controlador de eventos de control de inscripción y devuelve
un estado de Éxito en el parámetro EventHandlerStatus .
Cuando una aplicación recibe este evento, debe eliminar la
plantilla de huella digital asociada con el dedo índice derecho.
El valor de la propiedad EnrolledFingerMask ahora se establece
en 000000000 000000000 o 0.
El color verde se elimina del dedo índice derecho, lo que
indica que la huella digital asociada ya no está registrada.
Capítulo 6: Interfaces gráficas de usuario Interfaz gráfica de usuario de DPFP.Gui.Verification
Interfaz gráfica de usuario de DPFP.Gui.Verification
La interfaz gráfica de usuario incluida con el objeto DPFP.Gui.Verification.VerificationControl consta de un
elemento. Este elemento se utiliza para indicar el estado de conexión del lector de huellas dactilares y para
proporcionar información sobre el proceso de verificación de huellas dactilares. La Tabla 8 ilustra y
describe la interacción entre el usuario y la interfaz gráfica de usuario.
Tabla 8. Interfaz gráfica de usuario de DPFP.Gui.Verification
Indica que el lector de huellas digitales está conectado y listo para que el usuario escanee un dedo.
Indica que el lector de huellas dactilares está desconectado.
Indica una decisión de comparación de coincidencia de una operación de verificación de
huellas dactilares.
Esta imagen aparece cuando se activa el evento OnComplete del controlador de eventos de control
de verificación y devuelve un estado de Éxito en el
Parámetro EventHandlerStatus .
Indica una decisión de comparación de no coincidencia de una operación de verificación de huellas
dactilares.
Esta imagen aparece cuando se activa el evento OnComplete del controlador de eventos de control
de verificación y devuelve un estado de falla en el
Parámetro EventHandlerStatus .
Indica que la operación de captura de muestras de huellas dactilares falló.
Desarrollo de aplicaciones compatibles con Citrix 7
Este SDK incluye compatibilidad con la autenticación de huellas dactilares a través de Windows Terminal Services (incluida
la conexión a escritorio remoto) ya través de una conexión de Citrix a Metaframe Presentation Server mediante un cliente del
paquete Citrix Presentation Server Client.
Los siguientes tipos de clientes Citrix son compatibles con la autenticación de huellas dactilares:
Programa Vecindario
Agente del Programa Vecindario
cliente web
Para utilizar este soporte, su aplicación (o el usuario final) deberá copiar un archivo en la computadora del cliente y registrarlo. El
nombre del archivo es DPICACnt.dll y se encuentra en la carpeta "Misc\Citrix Support" en el paquete del producto.
Para implementar la biblioteca DigitalPersona para compatibilidad con Citrix:
1. Localice el archivo DPICACnt.dll en la carpeta "Misc\Citrix Support" dentro del paquete del producto.
2. Copie el archivo en la carpeta del equipo cliente donde se encuentran los componentes del cliente Citrix (es decir, para el
cliente de Program Neighborhood podría ser la carpeta "Program Files\Citrix\ICA Client").
3. Con el programa regsvr32.exe, registre la biblioteca DPICACnt.dll.
Si tiene varios clientes Citrix instalados en una computadora, implemente la biblioteca DPICACnt.dll en la carpeta del cliente
Citrix para cada cliente.
Si su aplicación también funcionará con Pro Workstation 4.2.0 y posterior o Pro Kiosk 4.2.0 y posterior, deberá informar al
administrador del usuario final que deberá habilitar dos Objetos de directiva de grupo (GPO), "Usar Servidor DigitalPersona Pro
para autenticación" y "Permitir redirección de datos de huellas dactilares". Para obtener información sobre cómo habilitar estas
políticas, consulte la "Guía de DigitalPersona Pro para AD.pdf" que se encuentra dentro del paquete de instalación de
DigitalPersona Pro Server.
Redistribución 8
Puede redistribuir los archivos en las carpetas RTE\Install y Redist en el paquete de software One Touch para Windows
SDK a sus usuarios finales de conformidad con los términos del acuerdo de licencia de usuario final (EULA), adjunto al software
y ubicado en los Documentos. carpeta en el paquete de software SDK.
Cuando desarrolla un producto basado en el SDK de One Touch para Windows, debe proporcionar los
redistribuibles a sus usuarios finales. Estos archivos están diseñados y autorizados para su uso con su aplicación. Puede incluir
los archivos de instalación ubicados en la carpeta RTE\Install en su aplicación, o puede incorporar los redistribuibles
directamente en su instalador. También puede usar los módulos de combinación ubicados en la carpeta Redist en el paquete de
software SDK para crear su propio instalador MSI.
Según los términos del EULA, DigitalPersona le otorga una licencia mundial no transferible y no exclusiva para redistribuir, ya
sea directamente o a través de los módulos de combinación respectivos, los siguientes archivos contenidos en las carpetas
RTE\Install y Redist en One Touch para Paquete de software SDK de Windows a sus usuarios finales e incorporar estos
archivos en trabajos derivados para la venta y distribución:
RTE\Carpeta de instalación
InstallOnly.bat
instalación.exe
Configuración.msi
UninstallOnly.bat
Carpeta Redist
La siguiente tabla indica qué módulos de combinación se requieren para admitir cada lenguaje de desarrollo y sistema operativo.
Módulo de fusión C/C++ COM/ActiveX .NETO Java
32 bits 64 bits 32 bits 64 bits 32 bits 64 bits 32 bits 64 bits
DpDrivers.msm X X X X X X X X
DpPolicies_OTW.msm X X X X X X X X
DpCore.msm X X X X X X X X
DpCore_x64.msm X X X X
DpProCore.msm X X X X
DpProCore_x64.msm X X X X
Capítulo 8: Redistribución Carpeta Redist
Módulo de fusión C/C++ COM/ActiveX .NETO Java
DpFpRec.msm X X X X
DpFpRec_x64.msm X X X X
DpFpUI.msm X X X X X X X X
DpFpUI_x64.msm X X X X
DpOTCOMActX.msm X X X X
DpOTCOMActX_x64.msm X X
DpOTDotNet.msm X X
DpOTShrDotNet.msm X X
DpOTJni.msm X X
DpOTJni_x64.msm X
DpOTJava.msm X X
Los módulos de combinación y los archivos que contienen se enumeran a continuación en orden alfabético.
DpCore.msm
Este módulo de combinación contiene los siguientes archivos:
Dpcoper2.dll
Dpdevice2.dll
Dpfpapi.dll
Dphostw.exe
Dpmux.dll
Dpmsg.dll
Dpclback.dll
DPCrStor.dll
DpCore_x64.msm
Dpcoper2.dll
Dpdevice2.dll
Dpfpapi.dll
Dphostw.exe
Dpmux.dll
Dpclback.dll
DPCrStor.dll
x64\Dpmsg.dll
DpDrivers.msm
Dpd00701x64.dll
Dpdevctlx64.dll
Dpdevdatx64.dll
Dpersona_x64.cat
Dpersona_x64.inf
Dpi00701x64.dll
Dpinst32.exe
Dpinst64.exe
Usbdpfp.sys
Dpersona.cat
Dpersona.inf
Dpdevctl.dll
Dpdevdat.dll
Dpk00701.sys
Dpk00303.sys
Dpd00303.dll
Dpd00701.dll
Dpi00701.dll
DpFpRec.msm
Dphftrex.dll
Dphmatch.dll
DpFpRec_x64.msm
<carpeta del sistema>\Dphftrex.dll
<carpeta del sistema>\Dphmatch.dll
<carpeta system64>\Dphftrex.dll
<carpeta system64>\Dphmatch.dll
DPFpUI.msm
Este módulo de combinación contiene el siguiente archivo:
Dpfpui.dll
DPFpUI_x64.msm
<carpeta del sistema>\Dpfpui.dll
<carpeta system64>\Dpfpui.dll
DpProCore.msm
Dpdevts.dll
Dpsvinfo2.dll
Dptsclnt.dll
DpOTCOMActX.msm
DPFPShrX.dll
DPFPDevX.dll
DPFPEngX.dll
DPFPCtlX.dll
DpOTCOMActX_x64.msm
Capítulo 8: Redistribución Documentación del lector de huellas dactilares
DPFPShrX.dll
DPFPDevX.dll
DPFPEngX.dll
DPFPCtlX.dll
x64\DpFpCtlX.dll
x64\DpFpDevX.dll
x64\DpFpEngX.dll
x64\DpFpShrX.dll
DpOTDotNET.msm
DPFPDevNET.dll
DPFPEngNET.dll
DPFPVerNET.dll
DPFPGuiNET.dll
DpOTShrDotNET.msm
DPFPShrNET.dll
Documentación del lector de huellas dactilares
Puede redistribuir la documentación incluida en la carpeta Redist en el paquete de software SDK de One Touch para Windows a sus
usuarios finales de conformidad con los términos de esta sección y del CLUF, adjunto al software y ubicado en la carpeta Docs en el
paquete de software SDK. .
Advertencias de hardware e información reglamentaria
Si distribuye lectores de huellas dactilares DigitalPersona U.are.U a sus usuarios finales, es responsable de informarles sobre las advertencias
y la información reglamentaria incluida en el archivo Advertencias e información reglamentaria.pdf en la carpeta Redist en el software SDK de
One Touch para Windows. paquete. Puede copiar y redistribuir el lenguaje, incluidos los avisos de derechos de autor y marcas registradas,
establecidos en el archivo Advertencias e información reglamentaria.pdf.
Capítulo 8: Redistribución Guía de uso y mantenimiento del lector de huellas dactilares
Guía de uso y mantenimiento del lector de huellas dactilares
Las guías de uso y mantenimiento del lector de huellas dactilares DigitalPersona U.are.U, DigitalPersona Reader
Maintenance Touch.pdf y DigitalPersona Reader Maintenance Swipe.pdf, se encuentran en la carpeta Redist en el
paquete de software One Touch para Windows SDK. Puede copiar y redistribuir los archivos DigitalPersona Reader
Maintenance Touch.pdf y DigitalPersona Reader Maintenance Swipe.pdf, incluidos los avisos de derechos de autor y
marcas registradas, a quienes le compren un módulo U.are.U o un lector de huellas dactilares.
Configuración de la tasa de aceptación falsa A
Este apéndice es para desarrolladores que desean especificar una tasa de aceptación falsa (FAR) distinta de la predeterminada utilizada
por DigitalPersona Fingerprint Recognition Engine.
Tasa de aceptación falsa (FAR)
La tasa de aceptación falsa (FAR), también conocida como nivel de seguridad, es la proporción de operaciones de verificación
de huellas dactilares por parte de usuarios autorizados que devuelve incorrectamente una decisión de comparación de coincidencia.
La FAR generalmente se establece como la proporción del número esperado de errores de aceptación falsa dividido por el número
total de intentos de verificación, o la probabilidad de que un sistema biométrico acepte falsamente a un usuario no autorizado. Por
ejemplo, una probabilidad de 0,001 (o 0,1 %) significa que de 1000 operaciones de verificación realizadas por usuarios autorizados, se
espera que un sistema devuelva 1 decisión de coincidencia incorrecta. Aumentar la probabilidad a, digamos, 0,0001 (o 0,01 %) cambia
esta relación de 1 en 1000 a 1 en 10 000.
Aumentar o disminuir la FAR tiene el efecto opuesto en la tasa de falsos rechazos (FRR), es decir, disminuir la tasa de falsas
aceptaciones aumenta la tasa de falsos rechazos y viceversa. Por lo tanto, un alto nivel de seguridad puede ser apropiado para un
sistema de acceso a un área segura, pero puede no ser aceptable para un sistema donde la comodidad o el fácil acceso son más
importantes que la seguridad.
Representación de probabilidad
El motor de reconocimiento de huellas dactilares DigitalPersona admite la representación de la probabilidad FAR que se ajusta
completamente a las especificaciones estándar BIOAPI 1.1, BioAPI 2.0 y UPOS. En esta representación, la probabilidad se
representa como un entero positivo de 32 bits o cero. (Los valores negativos están reservados para usos especiales).
La definición PROBABILITY_ONE proporciona una forma conveniente de usar esta representación. PROBABILITY_ONE tiene el valor
0x7FFFFFFF (donde el prefijo 0x denota notación de base 16), que es 2147483647 en notación decimal. Si la probabilidad (P) está
codificada por el valor (INT_N), entonces
INT_N = P * PROBABILIDAD_UNO
INT_N
PAG =
PROBABILIDAD_UNO
La probabilidad P siempre debe estar en el rango de 0 a 1. Algunas representaciones comunes de probabilidad se enumeran en la
columna uno de la Tabla 2. El valor en la tercera fila representa el valor predeterminado actual utilizado por DigitalPersona
Fingerprint Recognition Engine, que ofrece un valor medio. rango de nivel de seguridad. El valor de la segunda fila representa un nivel
de seguridad FAR alto/bajo típico, y el valor de la cuarta fila representa un nivel de seguridad FAR bajo/alto típico.
El valor resultante de INT_N se representa en la columna dos, en notación decimal.
Apéndice A: Configuración de la tasa de aceptación falsa
Tabla 2. Valores comunes de probabilidad y valores INT_N resultantes
Probabilidad (P) Valor de INT_N en notación decimal
0,001 = 0,1 % = 1/1000 2147483
0.0001 = 0.01% = 1/10000 214748
0.00001 = 0.001% = 1/100000 21475
0.000001 = 0.0001% = 1/1000000 2147
FAR solicitado
Especifique el valor de FAR, que es INT_N de la ecuación anterior, utilizando la propiedad FARRequested (página 92). Si bien
puede solicitar cualquier valor desde 0 hasta el valor PROBABILITY_ONE, no se garantiza que Engine cumplirá exactamente con la
solicitud. La implementación del motor hace el mejor esfuerzo para acomodar la solicitud estableciendo internamente el
valor más cercano al solicitado dentro de las restricciones que impone por seguridad.
Especificando el FAR en C#
Si está desarrollando su aplicación en C#, especifique el valor de FAR (INT_N) en la propiedad FARRequested del objeto
DPFP.Verification.Verification . El siguiente código de ejemplo establece el FAR en un valor de 0,000001 o 0,0001 %.
int estático PROBABILITY_ONE = 0x7FFFFFFF;
DPFP.Verification.Verification verificación = nuevo
DPFP.Verificación.Verificación();
...
//Establece el FAR en 0.0001% de
verificación.FARRequested = PROBABILITY_ONE / 1000000;
También puede establecer el valor de FAR a través de la construcción, como se muestra en el siguiente código de ejemplo.
int estático PROBABILITY_ONE = 0x7FFFFFFF;
//Construye y establece el FAR en 0.0001%
DPFP.Verificación.Verificación verificación =
nuevo DPFP.Verification.Verification(PROBABILITY_ONE / 1000000);
Apéndice A: Configuración de la tasa de aceptación falsa
Especificando el FAR en Visual Basic
Si está desarrollando su aplicación en Visual Basic, especifique el valor de FAR (INT_N) en la propiedad FARRequested del
objeto DPFP.Verification.Verification . El siguiente código de ejemplo establece el FAR en un valor de 0,0001 o 0,01 %.
Const PROBABILITY_ONE como Long = &H7FFFFFFF
Dim verificación como nuevo DPFP.Verification.Verification()
...
' Establece el FAR en 0.01%
verificación.FARRequested = PROBABILITY_ONE / 10000
También puede establecer el valor de FAR a través de la construcción, como se muestra en el siguiente código de ejemplo.
Const PROBABILITY_ONE como Long = &H7FFFFFFF
' //Construye y establece la verificación FAR a 0.01% Dim como
nueva DPFP.Verification.Verification(PROBABILITY_ONE / 10000)
Logrado LEJOS
El valor real de FAR logrado para una operación de verificación en particular se devuelve en la propiedad
DPFP.Verification.Result.FARAchieved (página 93). Este valor suele ser mucho más pequeño que el FAR solicitado debido a la
precisión del motor de reconocimiento de huellas dactilares de DigitalPersona. La FAR solicitada especifica el valor máximo de
la FAR que utilizará el motor para tomar la decisión de verificación. El FAR real logrado por el motor al realizar una comparación
legítima suele ser un valor mucho más bajo. La implementación del motor puede elegir el rango y la granularidad para el FAR logrado.
Si utiliza este valor en su aplicación, por ejemplo, al combinarlo con otras FAR logradas, debe usarlo con precaución, ya que la
granularidad y el rango pueden cambiar entre versiones de DigitalPersona SDK sin previo aviso.
Pruebas
Aunque puede lograr los valores deseados de FAR en su entorno de desarrollo, no se garantiza que su aplicación alcance
el nivel de seguridad requerido en situaciones del mundo real. Aunque el motor está diseñado para hacer su mejor esfuerzo para
implementar con precisión las estimaciones de probabilidad, se recomienda realizar pruebas a nivel del sistema para
determinar el punto de funcionamiento real y la precisión en un escenario determinado. Esto es aún más importante en sistemas donde
se utilizan múltiples factores biométricos para la identificación.
Conversión de plantilla de inscripción Platinum SDK B
Este apéndice es para usuarios de Platinum SDK que necesitan convertir sus plantillas de registro de Platinum SDK a un formato que sea
compatible con los SDK que se enumeran en Compatibilidad de plantillas de huellas dactilares en la página 5.
El código de muestra se incluye a continuación para C++ y Visual Basic.
Conversión de plantillas de inscripción Platinum SDK para Microsoft Visual C++
Utilice Code Sample 1 en aplicaciones desarrolladas en Microsoft Visual C++ para convertir las plantillas de inscripción SDK de
DigitalPersona Platinum.
Ejemplo de código 1. Conversión de plantillas Platinum SDK para Microsoft Visual C++
#import "DpSdkEng.tlb" no_namespace, named_guids, raw_interfaces_only #include <atlbase.h>
bool PlatinumTOGold(caracteres sin firmar* platinumBlob, int platinumBlobSize, caracteres sin firmar* goldBlob,
int goldBufferSize, int* goldTemplateSize)
{
// Cargue la matriz de bytes en FPTemplate Object // para crear un
objeto de plantilla Platinum SAFEARRAYBOUND rgsabound;
rgsabound.lLbound = 0;
rgsabound.cElements =
platinumBlobSize;
CComVariante varVal;
varVal.vt = VT_ARRAY | VT_UI1; varVal.array
= SafeArrayCreate(VT_UI1, 1, &rgsabound);
datos char* sin firmar; if
(FAILED(SafeArrayAccessData(varVal.parray, (void**)&data)))
falso retorno;
memcpy(datos, platinumBlob, platinumBlobSize);
SafeArrayUnaccessData(varVal.array);
IFPTemplatePtr pIFPTemplate(__uuidof(FPTemplate));
si (pIFPTemplate == NULL)
falso retorno;
Apéndice B: Conversión de la plantilla de inscripción Platinum SDK
Ejemplo de código 1. Conversión de plantillas Platinum SDK para Microsoft Visual C++
AIErrors error; if
(FALLIDO(pIFPTemplate>Importar(varVal, &error)))
falso retorno;
si (error != Er_OK) devuelve
falso;
// Ahora pIFPTemplate contiene la plantilla Platinum.
// Usa la propiedad TemplData para sacar la plantilla dorada.
CComVariant varValGold;
if (FAILED(pIFPTemplate>get_TemplData(&varValGold))) devuelve falso;
carácter sin firmar* dataGold; if
(FAILED(SafeArrayAccessData(varValGold.parray, (void**)&dataGold)))
falso retorno;
int blobSizeRequired = varValGold.parray>rgsabound>cElements *
varValOro.parray>cbElements;
*goldTemplateSize = blobSizeRequired;
if (goldBufferSize < blobSizeRequired) {
SafeArrayUnaccessData(varValGold.array); falso retorno;
memcpy(goldBlob, dataGold, blobSizeRequired);
SafeArrayUnaccessData(varValGold.array);
devolver verdadero;
Apéndice B: Conversión de la plantilla de inscripción Platinum SDK
Conversión de plantilla de inscripción Platinum SDK para Visual Basic 6.0
Utilice Code Sample 2 en aplicaciones desarrolladas en Microsoft Visual Basic 6.0 para convertir las plantillas de inscripción
de DigitalPersona Platinum SDK.
Ejemplo de código 2. Conversión de plantillas Platinum SDK para Visual Basic 6.0
Función pública PlatinumToGold(platinumTemplate As Variant) As Byte()
Dim pTemplate como nuevo FPTemplate
Dim vGold como variante
Dim bGold() como byte
Dim es como DpSdkEngLib.AIErrors es =
pTemplate.Import(platinumTemplate)
Si es <> Is_OK Entonces PlatinumToGold = "": Salir de la función vGold =
pTemplate.TemplateData bGold = vGold
PlatinoAOro = bOro
función final
Glosario
sistema biométrico Un características
método automático para identificar a una persona basado en Ver funciones de huellas dactilares.
los rasgos físicos y/o de comportamiento únicos de la persona,
como una huella dactilar o un patrón de iris, o una firma manuscrita huella dactilar
o una voz. Una impresión de las crestas en la piel de un dedo.
comparación La dispositivo de captura de huellas
estimación, el cálculo o la medida de la similitud o diferencia entre dactilares Un dispositivo que recoge una señal de las características
los conjuntos de características de huellas dactilares y las de las huellas dactilares de un sujeto de datos de huellas dactilares y la
plantillas de huellas dactilares. convierte en una muestra de huellas dactilares. Un dispositivo puede
ser cualquier pieza de hardware (y software y firmware compatibles). En
puntuación de comparación algunos sistemas, convertir una señal de las características de la huella
El valor numérico resultante de una comparación de conjuntos de dactilar en una muestra de la huella dactilar puede incluir varios
características de huellas dactilares con plantillas de componentes, como una cámara, papel fotográfico, impresora, escáner
huellas dactilares. Las puntuaciones de comparación pueden digital o tinta y papel.
ser de dos tipos: puntuaciones de similitud o puntuaciones de disimilitud.
característica de la huella dactilar
Motor de reconocimiento de huellas dactilares de DigitalPersona Un Detalles biológicos de la superficie del dedo que se pueden detectar y de
conjunto de algoritmos matemáticos formalizados para determinar los cuales se pueden extraer conjuntos de características
si un conjunto de funciones de huellas dactilares coincide con distintivas y repetibles de la huella dactilar con el fin de verificar o
una plantilla de huellas dactilares de acuerdo con un nivel de registrar huellas dactilares.
seguridad específico en términos de tasa de aceptación falsa (FAR).
datos de huellas
afiliado
dactilares El conjunto de funciones de huellas dactilares, la plantilla
Ver sujeto de datos de huellas dactilares. de huellas dactilares o la muestra de huellas dactilares.
inscripción objeto de datos de huellas
Ver inscripción de huellas dactilares. dactilares Un objeto que hereda las propiedades de un objeto DPFP.Data.
Los objetos de datos de huellas dactilares incluyen DPFP.Sample
tasa de aceptación falsa (FAR) (representa una muestra de huellas dactilares), DPFP.FeatureSet
La proporción de transacciones de verificación de huellas (representa un conjunto de funciones de huellas dactilares)
dactilares por parte de sujetos de datos de huellas dactilares y DPFP.Template (representa una plantilla de huellas dactilares).
no inscritos en el sistema donde se devuelve una decisión incorrecta
de coincidencia. subsistema de almacenamiento de datos de huellas
dactilares Un medio de almacenamiento donde las plantillas de huellas
tasa de rechazo falso (FRR) dactilares se almacenan como referencia. Cada plantilla de huellas
La proporción de transacciones de verificación de huellas dactilares está asociada con un sujeto de registro de huellas dactilares.
dactilares por parte de los sujetos de registro de huellas dactilares Las plantillas de huellas dactilares se pueden almacenar dentro
contra su(s) propia(s) plantilla(s) de huellas dactilares donde se de un dispositivo de captura de huellas dactilares; en un medio portátil como
devuelve una decisión incorrecta de no coincidencia. una tarjeta inteligente; localmente, como en una computadora personal o un
servidor local; o en una base de datos central.
Glosario
sujeto de datos de huellas dactilares imagen de huella dactilar
Una persona cuyas muestras de huellas dactilares, conjuntos de Una representación digital de las características de la huella dactilar antes de
características de huellas dactilares o plantillas de huellas dactilares están la extracción que se obtienen de un lector de huellas dactilares. Véase
presentes en el sistema de reconocimiento de huellas dactilares en también muestra de huellas dactilares.
cualquier momento. Los datos de huellas dactilares pueden ser de una
persona reconocida o de un sujeto de registro de huellas dactilares. lector de huellas dactilares
Dispositivo que recopila datos de las características de las huellas dactilares de
una persona y los convierte en una muestra de huellas dactilares.
registro de huellas dactilares a. En
un sistema de reconocimiento de huellas dactilares, el proceso inicial de sistema de reconocimiento de huellas dactilares
recopilación de datos de huellas dactilares de una persona mediante la Un sistema biométrico que utiliza las características distintivas y
extracción de las características de las huellas dactilares de la imagen persistentes de las crestas de un dedo, también conocidas como características
de la huella dactilar de la persona con el fin de inscribirlos y luego de huellas dactilares, para distinguir un dedo (o persona) de otro.
almacenar los datos resultantes en una plantilla para una comparación
posterior.
Muestra de huellas dactilares
b. La función del sistema que calcula una plantilla de huellas dactilares a partir
La representación analógica o digital de las características de las huellas
de un conjunto de funciones de huellas dactilares.
dactilares antes de la extracción de las características de las huellas dactilares
sujeto de inscripción de huellas dactilares El que se obtienen de un dispositivo de captura de huellas dactilares. Una muestra
de huellas dactilares puede ser cruda (tal como se captura),
sujeto de datos de huellas dactilares cuyas plantillas de huellas
intermedia (después de algún procesamiento) o procesada.
dactilares se mantienen en el subsistema de almacenamiento de datos de
huellas dactilares.
plantilla de huellas dactilares El
extracción de características de huellas dactilares resultado de un proceso de inscripción de huellas dactilares completado que
se almacena en un subsistema de almacenamiento de datos de huellas
La función del sistema que se aplica a una muestra de huellas dactilares para
dactilares. Las plantillas de huellas dactilares se almacenan para su posterior
calcular información repetible y distintiva que se utilizará para la
comparación con un conjunto de funciones de huellas dactilares.
verificación de huellas dactilares o el registro de huellas dactilares. El
resultado de la función de extracción de características de huellas
verificación de huellas dactilares a.
dactilares es un conjunto de características de huellas dactilares.
En un sistema de reconocimiento de huellas dactilares, el proceso de extraer
las características de las huellas dactilares de la imagen de la huella dactilar
características de las huellas de una persona proporcionada con fines de verificación, comparar los
datos resultantes con la plantilla generada durante el registro y decidir si
dactilares Las características distintivas y persistentes de las crestas en la
los dos coinciden.
piel de un dedo. Véase también características de las huellas
dactilares.
b. La función del sistema que realiza una comparación uno a uno y toma una
conjunto de características de decisión de coincidencia o no coincidencia.
huellas dactilares El resultado de un proceso completo de extracción
de características de huellas dactilares aplicado a una muestra de huellas dactilares.
fósforo
Se pueden producir conjuntos de características de huellas dactilares con el
fin de verificar las huellas dactilares o con el fin de registrar las La decisión de que los conjuntos de características de huellas dactilares y
huellas dactilares. las plantillas de huellas dactilares que se comparan son del mismo sujeto de
datos de huellas dactilares.
Glosario
no coincide
La decisión de que los conjuntos de características de huellas dactilares
y las plantillas de huellas dactilares que se comparan no son del mismo
sujeto de datos de huellas dactilares.
comparación uno a uno El proceso
en el que los conjuntos de características de reconocimiento de
huellas dactilares de uno o más dedos de un sujeto de datos de
huellas dactilares se comparan con plantillas de huellas
dactilares de uno o más dedos de un sujeto de datos de huellas dactilares.
repositorio
Véase subsistema de almacenamiento de datos dactiloscópicos.
nivel de seguridad
La tasa de aceptación falsa de destino para un contexto de
comparación. Véase también LEJOS.
verificación
Ver verificación de huellas dactilares.
Índice
A para Microsoft Visual C++ 114
propiedad activa Método ConvertToANSI381 (muestra, byte de referencia []),
Clase DPFP.Gui.Verification.VerificationControl definido 61
definido 80 Método ConvertToPicture (muestra, mapa de bits de referencia),
Método AddFeatures(Conjunto de características) definido 62
llamando en el flujo de trabajo típico de registro de huellas dactilares 23 Tipo de letra en negrita Courier, uso de 3
definido 85 CreateFeatureSet(Muestra, DataPurpose, ref
recursos adicionales 4 recursos Llamada al método CaptureFeedback, ref. FeatureSet) en el
en línea 4 documentación flujo de
relacionada 4 trabajo típico de registro de huellas dactilares 23 en el flujo de
Permitir la redirección de datos de huellas dactilares 104 trabajo típico de verificación de huellas dactilares 30 definido 83
API
lista de componentes 37
D
Ver también componentes individuales por referencia de
Clase de
nombre 36–93
datos Ver DPFP. Objeto
B de datos de
sistema biométrico clase de datos Ver objeto de datos
definido 117 de huellas digitales Data()
explicado 18 tipo constructor 38 Data(Stream) constructor, definido
de letra en negrita, usos de 3 38 eliminar una huella digital
Propiedad de construcción, definida 60 Ver cancelar el registro de una huella digital
Propiedad de bytes, definida 40 Llamada al método DeSerialize(byte[])
en el flujo de trabajo de deserialización de objetos de datos de huellas
dactilares 35
Clase C Capture definido 39
Véase DPFP.Capture.Capture componente
Llamada al método DeSerialize(Stream)
de captura de clase 46
en el flujo de trabajo de deserialización de objetos de datos de huellas
Constructor Capture(), definido 48 dactilares 35
Constructor Capture(Priority), definido 47 Constructor definido 40
Capture(String, Priority), definido 46 Constructor Capture(String),
deserialización del flujo de trabajo del objeto de datos de huellas
definido 47 Citrix 1 Citrix Web Cliente 1 Citrix,
dactilares 35 DigitalPersona Developer Connection Forum, URL a 4 Motor de
reconocimiento de huellas dactilares DigitalPersona 18 Sistema de
desarrollando para 104
reconocimiento de huellas dactilares DigitalPersona 19 Productos
llamadas al método Clear() en un
DigitalPersona, compatibles 5 Convenciones de
flujo de trabajo documentos 3 Documentación
típico de registro de huellas dactilares 24 definido 86 relacionada 4 Espacio de nombres
DPFP, definido 38 Espacio de nombres
comparación, definió 117 plantillas
DPFP.Capture, definido 46 DPFP. Clase Capture.Capture
de huellas dactilares compatibles
que crea una nueva instancia de
Ver compatibilidad de plantillas de huellas dactilares
constructores para 46 aviso
componentes de la lista API importante de que la
de 37
configuración de prioridad y lectores no se puede cambiar después de la
Véase también componentes individuales por convenciones
construcción 23, 30
de nombres, documento
en el flujo de trabajo típico de registro de huellas dactilares 23 en
Ver convenciones del documento
el flujo de trabajo típico de verificación de huellas dactilares 30
conversión de plantillas de inscripción Platinum SDK definido 46
para Microsoft VB 6.0 116
Índice
Enumeración DPFP.Capture.CaptureFeedback, definida 63 constructor para 85 en el
flujo de trabajo típico de inscripción de huellas dactilares 23 definido
Interfaz DPFP.Capture.EventHandler, definida 65 Enumeración 85
DPFP.Capture.Priority, definida 64 Clase DPFP.Capture.ReaderDescription, Clase DPFP.Processing.FeatureExtraction que crea una
definida 50 Clase DPFP.Capture.ReadersCollection, definida 56 Clase nueva instancia de constructor para
DPFP.Capture.ReaderVersion, definida 59 DPFP.Capture.SampleConversion 83 en el flujo de trabajo
clase, definida 61 Clase DPFP.Data, definida 38 Clase típico de inscripción de huellas dactilares 23 en el flujo de trabajo
DPFP.Error.SDKException, definida 43 Clase DPFP.FeatureSet, definida típico de verificación de huellas dactilares 30 definido 83 DPFP.Clase
41 Creación de objetos DPFP.FeatureSet de ejemplo,
en el flujo de trabajo típico de inscripción de huellas dactilares definida 42 Objeto DPFP.Sample, que regresa
23 en el flujo de trabajo típico de verificación de en el flujo de trabajo típico de inscripción de
huellas dactilares 30 recepción, en huellas dactilares 23 en la verificación típica de huellas dactilares
la verificación flujo de trabajo 30 DPFP.Clase de plantilla, definida 43 DPFP.Creación
típica de huellas dactilares con flujo de trabajo de soporte de interfaz de objetos de plantilla, en el flujo de trabajo
de usuario 33 Espacio de nombres DPFP.Gui, definido 69 Interfaz típico de registro de huellas
gráfica de usuario DPFP.Gui.Enrollment 94 Espacio de nombres dactilares 23 que regresa, en el flujo de trabajo típico de registro de huellas
DPFP.Gui.Enrollment, definido dactilares con soporte de interfaz de usuario 26 serialización, en el flujo de
70 Clase DPFP.Gui.Enrollment.EnrollmentControl trabajo típico de registro de
huellas dactilares con soporte de IU 26
DPFP.Verification espacio de nombres, definido 90
creación de una nueva instancia de DPFP.Verification.Result class, definido 93
constructor para 70 en la DPFP.Verification.Result objeto, recibir
inscripción típica de huellas dactilares con flujo de trabajo de soporte de en el flujo de trabajo típico de verificación de huellas dactilares con
interfaz de usuario 26 soporte de IU 33
en la cancelación típica de huellas dactilares con soporte de interfaz de usuario en el flujo de trabajo típico de verificación de huellas dactilares 31
flujo de trabajo 27 DPFP.Verification.Verification clase que crea una
definido 70 nueva instancia de constructores
DPFP.Gui.Enrollment.EventHandler interfaz, definida 73 DPFP.Gui.EventHandlerStatus para 90 en el flujo de trabajo
valor de configuración del objeto en la inscripción típica típico de verificación de huellas dactilares con soporte de IU 33 en el
de huellas dactilares flujo de trabajo
con flujo de trabajo de soporte de interfaz de usuario 26 típico de verificación de huellas dactilares 30 definido 90
en la cancelación típica de huellas dactilares con soporte de interfaz de usuario
Y
flujo de trabajo 27
Motor
en verificación típica con flujo de trabajo de soporte de IU 33
Consulte también la enumeración DPFP.Gui.EventHandlerStatus Ver el motor de reconocimiento de huellas dactilares de DigitalPersona
Propiedad EnrolledFingerMask definida 70
Interfaz gráfica de usuario DPFP.Gui.Verification 103 Espacio de nombres
usando en la
DPFP.Gui.Verification, definido 80 Interfaz
DPFP.Gui.Verification.EventHandler, definida 81 Clase
DPFP.Gui.Verification.VerificationControl inscripción típica de huellas dactilares con flujo de trabajo de soporte de
interfaz de usuario 26
creando una nueva instancia de
constructor para 80 en la en la cancelación típica de huellas dactilares con soporte de interfaz de usuario
flujo de trabajo 27
verificación de huellas dactilares típica con flujo de trabajo de soporte de
afiliado 19
UI 33 definido 80
definido 117
inscribir una huella dactilar 25
DPFP.Processing espacio de nombres, definido 83
inscripción
DPFP.Processing.DataPurpose enumeración, definido 88 DPFP.Processing.Enrollment
Ver registro de huellas dactilares
clase creando nueva instancia de
Clase de inscripción
Índice
Consulte DPFP.Processing.Enrollment máscara de Propiedad FARAlograda definida
inscripción de clase, valores posibles para el espacio de 93
nombres de inscripción 71 Consulte FARRequested propiedad definida
DPFP.Gui.Enrollment namespace 92 aviso
Constructor de inscripción (), definido 85 importante para leer el Apéndice A antes de configurar 91, 92
Clase de control de inscripción configuración en
Consulte la clase DPFP.Gui.Enrollment.EnrollmentControl verificación
Constructor EnrollmentControl(), definido 70 Propiedad ErrorCode, de huellas dactilares típica con flujo de trabajo de soporte de interfaz de
definida 43 Enumeración ErrorCodes, definida usuario 33 en flujo
44 Propiedad EventHandler Clase DPFP.Capture.Capture de trabajo de verificación de huellas dactilares típica 30 a un valor
definida 50 aviso importante para diferente al predeterminado 112
cargar al menos un controlador de eventos Clase FeatureExtraction
50 Consulte la clase DPFP.Processing.FeatureExtraction
Constructor de FeatureExtraction(), 83 funciones definidas
Clase DPFP.Gui.Enrollment.EnrollmentControl Ver funciones de huellas dactilares
definido 71 Constructor FeatureSet(), definido 41
aviso importante para cargar al menos un controlador de eventos Constructor FeatureSet(Stream), definido 41
71 Características Propiedad necesaria, archivos y carpetas
Clase DPFP.Gui.Verification.VerificationControl definidos 86 instalados
definido 81 para RTE, instalación de 32 bits 15 instalada para RTE,
aviso importante para cargar al menos un controlador de eventos instalación de 64 bits 16 instalada para SDK 14 índice de
81 dedo, valores posibles para
74
configuración en el flujo de trabajo típico de registro de huellas dactilares con Parámetro de dedo, valores posibles para 73 huella digital 18
soporte de interfaz definido 117 flujo de
de usuario 26 en el flujo de trabajo típico de registro de huellas trabajo para
dactilares 23 en la cancelación típica de registro de huellas dactilares con soporte de IU inscribirse con soporte de interfaz de usuario 25 flujo de trabajo
flujo de trabajo 27 para anular la inscripción (eliminación) con soporte de interfaz de usuario 27
en la verificación de huellas dactilares típica con soporte de interfaz de dispositivo de captura de huellas dactilares
usuario flujo de 19 definido 117
trabajo 33 en el flujo de trabajo de verificación de huellas dactilares típica 30 Ver lector de huellas características
Enumeración EventHandlerStatus, 69 excepciones definidas, de huellas dactilares, definido 117 datos de huellas
discusión de 36 dactilares 19 definido 117
F
objeto de datos de huellas dactilares 38
tasa de aceptación falsa 20
definido 117
definido 117 ajuste
deserialización 35
a un valor diferente al predeterminado 111 decisión de falso
serialización 34
negativo 20 decisión de falso negativo,
subsistema de almacenamiento de datos de huellas dactilares, definido
proporción de 20
117 sujeto de datos de huellas dactilares, definido 118
Véase también tasa de aceptación falsa
eliminación de huellas dactilares
decisión de falso positivo 20 decisión
Ver cancelación de registro de huellas
de falso positivo, proporción de 20
dactilares registro de huellas dactilares
Véase también tasa de falsos
19 definido 118
aceptados falsos positivos y falsos negativos 20 tasa de
con soporte de interfaz de usuario, flujos de
falsos rechazos 20 definida trabajo 25 flujo de
117
trabajo 21 extracción de funciones de huellas
LEJOS
dactilares definida
Ver tasa de aceptación falsa
118 conjunto de funciones de huellas dactilares 19
Índice
definido 118 Propiedad HardwareRevision, definida 52
características de huellas dactilares, definido 118
imagen de huellas dactilares, definido 118
yo imagen
Ver también muestra de huella lector de
Consulte la notación importante
huellas dactilares 19 definido
de la imagen de la huella digital, definición de
118 documentación
3 avisos importantes La
redistributiva para 109 guías de uso y mantenimiento,
aplicación debe verificar la propiedad TemplateStatus antes de leer la
redistribución 110 reconocimiento de huellas dactilares 19 sistema de
propiedad Plantilla 87
reconocimiento de huellas dactilares 18
al menos un controlador de eventos debe cargarse para recibir
definido 118
eventos de control de inscripción de huellas dactilares 71
se debe cargar al menos un controlador de eventos para recibir eventos de
Consulte también el reconocimiento de huellas dactilares del sistema de
operación de captura de muestras de huellas dactilares 50 se debe
reconocimiento de huellas dactilares DigitalPersona,
cargar al menos un controlador de eventos para recibir
guía para la captura de
eventos de control de verificación de huellas dactilares 81 la
muestras de 4
prioridad o la configuración del lector del objeto DPFP.Capture.Capture no
huellas dactilares en el flujo de trabajo típico de registro de huellas
dactilares con se puede cambiar después de la construcción
23, 30 lea el Apéndice A antes
soporte de interfaz de usuario 26 en el flujo de trabajo típico de
de configurar FARRequested 91, 92 establezca propiedades opcionales para
registro de huellas dactilares 23 en el flujo de trabajo típico de verificación
mantener una funcionalidad de aplicación consistente 36 propiedad
de huellas
ImpressionType, definida 52 instalación
dactilares con soporte de interfaz de usuario 33 en el flujo de trabajo
típico de verificación de huellas dactilares 30 definido 118 13 instalación archivos para redistribuibles
Véase también imagen de huella digital
plantilla de huellas dactilares 19
redistribuir 105 instalar
creación, flujo de trabajo para 21
creación, flujo de trabajo para con soporte de interfaz de usuario
RUTA 14
25 definido 118
RTE en silencio 17
deserialización 35
SDK 13
serialización 34
introducción al tipo de letra en
compatibilidad con plantillas de huellas dactilares 5
cursiva SDK 6, usos de 3
cancelación de inscripción de huellas dactilares, flujo de
trabajo 27 verificación de huellas L
dactilares 19
Propiedad del lenguaje, definida 52
definido 118 con soporte de interfaz de
usuario, flujo de trabajo 32 flujo de trabajo 28 METRO
Propiedad FirmwareRevision, definida 51 carpetas y Propiedad principal, definida 60
archivos instalados para coincidencia
20 definida 118
RTE, instalación de 32 bits 15 instalada para RTE,
instalación de 64 bits 16 instalada para SDK 14 La propiedad MaxEnrollFingerCount definió la
configuración
FRR 72, en la inscripción típica de huellas dactilares con la interfaz de usuario
flujo de trabajo de soporte 26
Ver tasa de rechazo falso
módulos de combinación
G contenido de 105
interfaces gráficas de usuario 94 redistribuir 105
Objetos de directiva de grupo 104 Servidor de presentación Metaframe 1
GUI component 69 Propiedad menor, definida 60
H N
advertencias de hardware e información reglamentaria, redistribución 109 convenciones de nomenclatura 3
sin coincidencia 20
Índice
definido 119 OnReaderConnect(Objeto, int, Plantilla, ref
convenciones de notación 3 Evento Gui.EventHandlerStatus), definido 77 Evento
notación de notas, definida 3 OnReaderConnect(Object, String), definido 67 Evento
OnReaderDisconnect(Object, int, Template, ref
O
Gui.EventHandlerStatus), definido 77 Evento
OnCancelEnroll(Objeto, int, Plantilla, ref
OnReaderDisconnect(Object, String), definido 67 OnSampeQuality(Object,
Gui.EventHandlerStatus), definido 73 Evento OnComplete
int , Plantilla, referencia
del controlador de eventos
Gui.EventHandlerStatus), evento definido 78
de la operación de captura de muestras de huellas dactilares, que
OnSampleQuality(Object, String, CaptureFeedback), evento definido
se recibe en el flujo de
68 OnStartEnroll(Object,
trabajo típico de registro de huellas dactilares 23 en el flujo
int, Template, ref
de trabajo típico de verificación de huellas dactilares 30
Gui.EventHandlerStatus), evento definido 78
Consulte también el evento OnComplete(Object, String, Sample)
desde el controlador de eventos de control de verificación de huellas dactilares, PAG
recibiendo en Conversión de plantilla de inscripción Platinum SDK 114
la verificación de huellas dactilares típica con flujo de trabajo de soporte de Propiedad prioritaria
interfaz de usuario 33 definida 49
Véase también OnComplete(Object, FeatureSet, ref componente de procesamiento 83
Gui.EventHandlerStatus) evento compatibilidad del producto
OnComplete(Object, FeatureSet, ref Ver compatibilidad de plantillas de huellas dactilares
Gui.EventHandlerStatus) evento, definido 82 Propiedad ProductName, definida 53
OnComplete(Object, String, Sample) evento, definido 65 Programa Barrio 1
OnCompleteEnroll(Object, int, Template, ref Programa Vecindario Agente 1
Evento Gui.EventHandlerStatus), definido 74 Evento
Q
OnDelete
inicio rápido 6
desde el controlador de eventos de control de inscripción de huellas dactilares,
recibiendo en R
la anulación de inscripción típica de huellas dactilares con soporte de interfaz de usuario Clase ReaderDescription Ver
flujo de trabajo 27
clase DPFP.Capture.ReaderDescription ReaderDescription
Véase también OnDelete(Object, int, ref este indexador [Guid], definido 57 ReaderDescription este indexador
Evento Gui.EventHandlerStatus) Evento [int], definido 58 ReaderDescription este indexador [cadena],
OnDelete(Object, int, ref Gui.EventHandlerStatus), definido 75 Evento definido 58 Constructor ReaderDescription(Guid), definido 50
OnEnroll del
Constructor ReaderDescription(String) , definida 51 Enumeración
controlador de
ReaderImpressionType, definida 54 Clase ReadersCollection
eventos de control de inscripción, recibiendo Consulte DPFP.Capture.ReadersCollection clase Constructor
en el registro típico de huellas dactilares con el flujo de trabajo de soporte de la ReadersCollection(), definida
interfaz de usuario 26
56 Propiedad ReaderSerialNumber definida
Véase también Evento OnEnroll(Object, int, Template, ref
Gui.EventHandlerStatus) Evento
OnEnroll(Object, int, Template, ref
Gui.EventHandlerStatus), definido 75 comparación uno a DPFP.Capture.Capture clase 49
uno 20 definido 119 Evento DPFP.Gui.Enrollment.EnrollmentControl clase 72
DPFP.Gui.Verification.VerificationControl clase 81
OnFingerGone(Object, String), definido 66 OnFingerRemove(Objeto,
int, Plantilla, ref configuración en el registro típico de huellas dactilares con flujo de trabajo de
Gui.EventHandlerStatus), evento definido 76 soporte de interfaz de usuario 26
OnFingerTouch(Objeto, int, Plantilla, ref en la verificación típica de huellas dactilares con flujo de trabajo de soporte de
Evento Gui.EventHandlerStatus), definido 76 Evento interfaz de usuario 33
OnFingerTouch(Object, String), definido 66 recursos en línea 4 Enumeración de ReaderTechnology, definida 55
Clase ReaderVersion
Índice
Véase DPFP.Capture.ReaderVersion class definido 38
ReaderVersion(uint, uint, uint) constructor, definición 59 Carpeta Redist, Llamada al método Serialize(Stream)
redistribución de contenidos de 105 redistribuibles, en el flujo de trabajo de serialización de objetos de datos de
redistribución 105 redistribución de archivos 105 huellas dactilares
Método Refresh(), definición 57 34 definido 39
información reglamentaria, requisito para flujo de trabajo de serialización de objetos de datos de huellas dactilares 34
asesorar a los usuarios finales Propiedad SerialNumber, definida 53
de 109 Enumeración SerialNumberType, definida 56
autenticación remota 1 Propiedad SerialNumberType, definida 53 componente
Remote Desktop Connection 1 repositorio compartido 38 instalación
19 requisitos, silenciosa RTE 17
sistema Propiedad de tamaño, definida 40
Consulte los recursos de requisitos Llamada al método StartCapture()
del sistema, adicionales en el
Ver recursos adicionales recursos, flujo de trabajo típico de registro de huellas dactilares 23 en el
en línea flujo de trabajo típico de verificación de huellas dactilares 30
Ver recursos en línea definido 48
RTE Enumeración de estado, definida 88
instalación 14 Llamada al método StopCapture()
instalación/desinstalación silenciosa 17 en el
redistribución 105 flujo de trabajo típico de inscripción de huellas dactilares 23 en
Carpeta RTE\Install, redistribución de contenidos del entorno de el flujo de trabajo típico de verificación de huellas dactilares 30
tiempo de ejecución 105 definido 49
Ver RTE productos DigitalPersona admitidos 5 requisitos del
sistema 4
S
ubicación de la aplicación T
de muestra de la demostración de la interfaz de usuario de VB.NET Propiedad tecnológica, compatibilidad definida
después de la instalación 14 con 54 plantillas
utilizando la demostración de la interfaz de usuario de VB.NET 7 código de Ver compatibilidad de plantillas de huellas dactilares
muestra para Propiedad de plantilla
convertir las plantillas de definida 87
inscripción Platinum SDK para Microsoft aviso importante para verificar la propiedad TemplateStatus antes de
VB 6.0 116 para Microsoft Visual C++ 114 leer 87
Constructor Sample(), definido 42 Constructor Constructor de plantilla (), definido 43
Sample(Stream) , definido 42 Constructor de plantilla (flujo) que llama al
Clase SampleConversion Ver clase flujo de trabajo de deserialización de objetos de datos de huellas
DPFP.Capture.SampleConversion Constructor dactilares 35
definido 43
SampleConversion(), definido 61 Archivos Propiedad TemplateStatus definida
y carpetas SDK 87 usando en
instalados 14 el flujo de trabajo típico de inscripción de huellas dactilares 23
instalación 13 inicio rápido Método ToString(), 59 tipos de letra
6 Clase SDKException Ver clase definidos, usos de 3
DPFP.Error.SDKException convenciones tipográficas 3
nivel de seguridad 21 serialización/deserialización del objeto de datos de huellas dactilares
U
flujos de trabajo 34
cancelar el registro de una huella digital
Llamar al método Serialize(ref byte[])
27 desinstalar RTE silenciosamente
en el flujo de trabajo de serialización de objetos de datos de
huellas dactilares 34 17 actualizaciones para productos de software DigitalPersona, URL para
descargar 4
Índice
URL
Foro de conexión de desarrolladores de DigitalPersona 4
Actualizaciones para productos de software DigitalPersona 4
guías de uso y mantenimiento para lectores de huellas dactilares,
redistribución 110
Utilice DigitalPersona Pro Server para la autenticación 104
V
VB.NET UI Ubicación de la aplicación de muestra
de demostración después de la
instalación
14 usando 7 Propiedad del proveedor,
definida 54
Verificación Ver verificación de
huellas dactilares
Clase de verificación Ver DPFP.Verificación. Clase de verificación
componente de verificación 90
espacio de nombres de
verificación Ver DPFP.Gui.Verification espacio de nombres
Constructor Verification(), definido 90
Constructor de verificación (int), definido 90
Control de verificación
Consulte la clase DPFP.Gui.Verification.VerificationControl.
Constructor de VerificationControl(), definido 80
Propiedad verificada, definida 93
Método de verificación (Conjunto de características, Plantilla, resultado de referencia)
llamando
en el flujo de trabajo típico de verificación de huellas dactilares con
soporte de interfaz
de usuario 33 en el flujo de trabajo típico de verificación de huellas
dactilares 31 definido 91
EN
Sitio web
Foro de conexión de desarrolladores de DigitalPersona 4
Actualizaciones para productos de software DigitalPersona 4
Flujos de trabajo de Windows Terminal
Services 1 21–35

One Touch For Windows SDK .NET Developer Guide

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

One Touch For Windows SDK .NET Developer Guide

Cargado por

Copyright:

Formatos disponibles

Machine Translated by Google

Solicitud de FAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

Especificación de FAR en C# . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

tipografía Objetivo Ejemplo

Atrevido Se utiliza para pulsaciones de teclas y elementos de ventanas Haga clic en Registro de huellas dactilares.

Cursiva Se usa para enfatizar o para introducir nuevos términos. Esta sección incluye ilustraciones de flujos de trabajo típicos de registro de

Carpeta Archivo Descripción

SDK de un toque\.NET\Bin DPFPShrNET.dll DLL utilizadas por One Touch para Windows: API de .NET

One Touch SDK\.NET\Docs One Touch para Windows SDK .NET DigitalPersona One Touch para SDK de Windows: Guía para

Carpeta Archivo Descripción

<carpeta de destino>\Bin DPCOper2.dll DLL y archivo ejecutable utilizado por todos los

GlobalAssemblyCacheGlobalAssemblyCache DPFPShrNET.dll DLL utilizadas por One Touch para Windows: API de .NET

<carpeta del sistema> DPFPApi.dll DLL utilizadas por todos los One Touch para Windows

Carpeta Archivo Descripción

<carpeta de destino>\Bin DPCOper2.dll DLL y archivo ejecutable utilizado por todos los

GlobalAssemblyCacheGlobalAssemblyCache DPFPShrNET.dll DLL utilizadas por One Touch para Windows: API de .NET

Carpeta Archivo Descripción

<carpeta del sistema> DPFPApi.dll DLL de 32 bits utilizados por todos los One Touch para

<carpeta system64> DPFPApi.dll DLL de 64 bits utilizados por todos los One Touch para

DPFP.Error.ErrorCodes Mensaje Razón

Interno Mala serialización La serialización falló, probablemente debido a limitaciones de memoria o

DPFP.Error.ErrorCodes Mensaje Razón

Interno Mala deserialización La deserialización falló, probablemente debido a limitaciones

DPFP.Error.ErrorCodes Mensaje Razón

Interno Mala serialización La serialización falló, probablemente debido a limitaciones de memoria o

DPFP.Error.ErrorCodes Mensaje Razón

Interno Mala deserialización La deserialización falló, probablemente debido a limitaciones

DPFP.Error.ErrorCodes Mensaje Razón

Interno Mala deserialización La deserialización falló, probablemente debido a limitaciones

DPFP.Error.ErrorCodes Mensaje Razón

Interno Mala deserialización La deserialización falló, probablemente debido a limitaciones

DPFP.Error.ErrorCodes Mensaje Razón

Interno Mala deserialización La deserialización falló, probablemente debido a limitaciones

DPFP.Error.ErrorCodes Mensaje Razón

No inicializado No se pudo inicializar El SDK no pudo inicializarse correctamente, posiblemente debido

DPFP.Error.ErrorCodes Mensaje Razón

No inicializado No se pudo inicializar El SDK no pudo inicializarse correctamente, posiblemente debido

DPFP.Error.ErrorCodes Mensaje Razón

No inicializado No se pudo inicializar El SDK no pudo inicializarse correctamente, posiblemente debido

DPFP.Error.ErrorCodes Mensaje Razón

No inicializado No se pudo inicializar El SDK no pudo inicializarse correctamente, posiblemente debido

DPFP.Error.ErrorCodes Mensaje Razón

No inicializado No se pudo inicializar El SDK no se pudo inicializar correctamente, posiblemente debido

Interno Error al iniciar la adquisición No se pudo iniciar la operación de captura de muestras de huellas dactilares.

DPFP.Error.ErrorCodes Mensaje Razón

No inicializado No se pudo inicializar El SDK no pudo inicializarse correctamente, posiblemente debido

DPFP.Error.ErrorCodes Mensaje Razón

No inicializado No se pudo inicializar El SDK no se pudo inicializar correctamente, posiblemente debido

DPFP.Error.ErrorCodes Mensaje Razón

No inicializado No se pudo inicializar El SDK no se pudo inicializar correctamente, posiblemente debido

Parametro invalido Índice o número de serie El formato del número de serie especificado no es válido.

DPFP.Error.ErrorCodes Mensaje Razón

No inicializado No se pudo inicializar El SDK no se pudo inicializar correctamente, posiblemente debido

Interno Error al enumerar lectores La enumeración de dispositivos falló.

DPFP.Error.ErrorCodes Mensaje Razón

No inicializado No se pudo inicializar El SDK no se pudo inicializar correctamente, posiblemente debido

Interno Error al enumerar lectores La enumeración de dispositivos falló.

DPFP.Error.ErrorCodes Mensaje Razón

DPFP.Error.ErrorCodes Mensaje Razón

Parametro invalido Índice o número de serie El índice especificado no está dentro del rango válido.

DPFP.Error.ErrorCodes Mensaje Razón

Parametro invalido Índice o número de serie El formato del número de serie especificado no es válido.

DPFP.Error.ErrorCodes Mensaje Razón