Você está na página 1de 190

DigitalPersona, Inc.

Una Touch® para Windows


SDK
COM / ActiveX Edición
versión 1.6

Guía del desarrollador


DigitalPersona, Inc.
© 1996-2010 Digital Persona, Inc. Todos los derechos reservados.
Todos los derechos de propiedad intelectual en el software DigitalPersona, firmware, hardware y
documentación que se incluyen con o descritos en esta guía son propiedad de DigitalPersona o de sus
proveedores y están protegidos por leyes de derechos de autor de los Estados Unidos, otras leyes de
propiedad intelectual y disposiciones de tratados internacionales. DigitalPersona y sus proveedores se
reservan todos los derechos no expresamente concedidos.
DigitalPersona, U.are.U y One Touch son marcas comerciales de Digital Persona, Inc., registradas en los Estados
Unidos y en otros países. Adobe y Adobe Reader son marcas comerciales 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 Vistason marcas comerciales registradas de Microsoft Corporation en los Estados
Unidos y en otros países.
Esta guía y el software que se describe suministra bajo licencia tal como se establece en el “Acuerdo de
licencia” que se muestra durante el proceso de instalación.
A excepción de lo permitido por dicha licencia o por los términos de esta guía, ninguna parte de este documento
puede ser reproducida, almacenada, transmitida, y se traduce, en cualquier forma y por cualquier medio, sin el
consentimiento previo por escrito de DigitalPersona. El contenido de esta guía se suministra con fines
únicamente con fines informativos y están sujetos a cambios sin previo aviso. Cualquier mención de empresas y
productos de terceros es sólo para fines de demostración y no constituye aprobación ni recomendación.
DigitalPersona no asume ninguna responsabilidad en relación con el rendimiento o el uso de estos productos de
terceros. DigitalPersona hace todo lo posible para garantizar la exactitud de su documentación y no asume
ninguna responsabilidad por los errores o imprecisiones que puedan aparecer en ella.

Soporte técnico
Tras la compra de un paquete de soporte de programador (disponible en http://buy.digitalpersona.com), usted
tiene derecho a un número determinado de horas de soporte telefónico y correo electrónico.

Realimentación
Aunque la información en esta guía ha sido revisado y probado a fondo, damos la bienvenida a sus
comentarios sobre cualquier error, omisión, o sugerencias para futuras mejoras. Por favor, póngase en
contacto con nosotros en
TechPubs@digitalpersona.com
o
DigitalPersona, Inc.
720 Bay Road, Suite 100
Redwood City, California
94063 EE.UU.
(650) 474-4000
(650) 298-8313 Fax

Documento Fecha de publicación: 22 Junio 2010 (1.6.0)


Mesa Contenido

1 Introducción1...........................................................................................................................
Objetivo Audience2.......................................................................................................................
Capítulo Overview2 ......................................................................................................................
Documento Conventions3 ............................................................................................................
notación Conventions3 ...........................................................................................................
tipográfico Conventions3 ........................................................................................................
nombrar Conventions3 ...........................................................................................................
Adicional recursos4 ......................................................................................................................
Relacionado Documentation4.................................................................................................
En línea recursos4 .................................................................................................................
Sistema Requirements4 ...............................................................................................................
Apoyado de DigitalPersona hardware products5 ..........................................................................
Plantilla de huella digital Compatibility5........................................................................................

2 Rápido Start6 ..........................................................................................................................


Rápido Concepts6........................................................................................................................
Instala el Software6 ......................................................................................................................
Conecte la huella digital Reader7 .................................................................................................
Utilizando la muestra Application7................................................................................................

3 Installation12 ...........................................................................................................................
Instalación de la SDK12 ...............................................................................................................
Instalación del entorno de tiempo de ejecución (RTE) 13.............................................................
Instalación y desinstalación de la RTE Silently16 .........................................................................

4 Overview17 .............................................................................................................................
biométrica sistema17 ...................................................................................................................
Fingerprint17 ................................................................................................................................
Huella dactilar Recognition18 .................................................................................................
Huella dactilar Enrollment18 ...................................................................................................
Huella dactilar Verification18 ..................................................................................................
Falso Positivos y falsos Negatives19 ............................................................................................
Workflows20 ................................................................................................................................
Inclusión de huellas digitales Workflow20...............................................................................
Inclusión de huellas digitales con la interfaz de usuario Support23 ........................................
Huella dactilar Verification26 ..................................................................................................
La verificación de huella digital con la interfaz de usuario Support29 .....................................
Objeto de datos de huellas dactilares Serialización / Deserialization32 ..................................

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del iii
desarrollador
5 Referencia API para Visual Basic Developers34 ....................................................................
Componente Objects34................................................................................................................
DPFPCapture36 .....................................................................................................................
StartCapture Method36 ....................................................................................................
StopCapture Method36.....................................................................................................
Prioridad Property36 .........................................................................................................
ReaderSerialNumber Property37 ......................................................................................
OnComplete Event38 .......................................................................................................
OnFingerGone Event38 ....................................................................................................
OnFingerTouch Event38 ...................................................................................................
OnReaderConnect Event39 ..............................................................................................
OnReaderDisconnect Event39 .........................................................................................
OnSampleQuality Event39................................................................................................
DPFPData40 ..........................................................................................................................
Deserialize Method40 .......................................................................................................
Publicar por fascículos Method40 .....................................................................................
DPFPEnrollment41 .................................................................................................................
Agrega características Method41 .....................................................................................
Claro Method41 ................................................................................................................
FeaturesNeeded Property41.............................................................................................
Modelo Property42............................................................................................................
TemplateStatus Property42 ..............................................................................................
DPFPEnrollmentControl43 .....................................................................................................
EnrolledFingersMask Property43 ......................................................................................
MaxEnrollFingerCount Property44 ....................................................................................
ReaderSerialNumber Property45 ......................................................................................
OnCancelEnroll Event46 ..................................................................................................
OnComplete Event46 .......................................................................................................
OnDelete Event47 ............................................................................................................
OnEnroll Event47 .............................................................................................................
OnFingerRemove Event48 ...............................................................................................
OnFingerTouch Event48 ...................................................................................................
OnReaderConnect Event48 ..............................................................................................
OnReaderDisconnect Event49 .........................................................................................
OnSampleQuality Event49................................................................................................
OnStartEnroll Event50 ......................................................................................................
DPFPEventHandlerStatus51 ..................................................................................................
Estado Property51 ............................................................................................................
DPFPFeatureExtraction51 ......................................................................................................
CreateFeatureSet Method52 ............................................................................................

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del iv
desarrollador
Conjunto de características Property52 ............................................................................
DPFPFeatureSet53 ................................................................................................................
Deserialize Method53 .......................................................................................................
Publicar por fascículos Method53 .....................................................................................
DPFPReaderDescription54 ....................................................................................................
FirmwareRevision Property54...........................................................................................
HardwareRevision Property54 ..........................................................................................
Idioma Property54 ............................................................................................................
ImpressionType Property55 ..............................................................................................
Nombre del producto Property55 ......................................................................................
Número de serie Property55 .............................................................................................
SerialNumberType Property56 .........................................................................................
Tecnología Property56 .....................................................................................................
Vendedor Property56........................................................................................................
DPFPReadersCollection58 .....................................................................................................
Lector Method58...............................................................................................................
Contar Property58 ............................................................................................................
ít Property59 .....................................................................................................................
_NewEnum Property59.....................................................................................................
DPFPSample60......................................................................................................................
Deserialize Method60 .......................................................................................................
Publicar por fascículos Method60 .....................................................................................
DPFPSampleConversion61 ....................................................................................................
ConvertToANSI381 Method61 ..........................................................................................
ConvertToPicture Method61 .............................................................................................
DPFPTemplate62 ...................................................................................................................
Deserialize Method62 .......................................................................................................
Publicar por fascículos Method62 .....................................................................................
DPFPVerification63 ................................................................................................................
Verificar Method63 ...........................................................................................................
FARRequested Property63 ...............................................................................................
DPFPVerificationControl64 .....................................................................................................
Activo Property64 .............................................................................................................
ReaderSerialNumber Property65 ......................................................................................
OnComplete Event65 .......................................................................................................
DPFPVerificationResult67 ......................................................................................................
FARAchieved Property67 ..................................................................................................
verificado Property67 ........................................................................................................
Enumerations68 ...........................................................................................................................
DPFPCaptureFeedbackEnum Enumeration69 .......................................................................

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del v
desarrollador
DPFPCapturePriorityEnum Enumeración ..................................................................................... 70
DPFPEventHandlerStatusEnum Enumeración .........................................................................................71
DPFPDataPurposeEnum Enumeración .....................................................................................................72
DPFPReaderImpressionTypeEnum Enumeración ....................................................................................73
DPFPReaderTechnologyEnum Enumeración ...........................................................................................73
DPFPSerialNumberTypeEnum Enumeración............................................................................................74
DPFPTemplateStatusEnum Enumeración.................................................................................................75

6 Referencia API para C ++ Desarrolladores ................................................................................... 76


Interfaces .................................................................................................................................. 76
IDPFPCapture Interfaz ................................................................................................................... 78
IDPFPCapture :: Prioridad Propiedad ...................................................................................... 78
IDPFPCapture :: ReaderSerialNumber Propiedad ............................................................................. 79
IDPFPCapture :: StartCapture Método .................................................................................... 79
IDPFPCapture :: StopCapture Método..................................................................................... 80
_IDPFPCaptureEvents Interfaz .................................................................................................................. 81
_IDPFPCaptureEvents :: OnComplete Evento ................................................................................... 81
_IDPFPCaptureEvents :: OnFingerGone Evento ............................................................................... 81
_IDPFPCaptureEvents :: OnFingerTouch Evento .............................................................................. 82
_IDPFPCaptureEvents :: OnReaderConnect Evento......................................................................... 82
_IDPFPCaptureEvents :: OnReaderDisconnect Evento .................................................................... 82
_IDPFPCaptureEvents :: OnSampleQuality Evento .......................................................................... 83
IDPFPData Interfaz ........................................................................................................................ 83
IDPFPData :: Deserialize Método ....................................................................................................... 83
IDPFPData :: Serialize Método............................................................................................................ 84
IDPFPEnrollment Interfaz ............................................................................................................... 85
IDPFPEnrollment :: addFeatures Método ................................................................................ 85
IDPFPEnrollment :: Borrar Método .......................................................................................... 85
IDPFPEnrollment :: FeaturesNeeded Propiedad ............................................................................... 85
IDPFPEnrollment :: Plantilla Propiedad ................................................................................... 86
IDPFPEnrollment :: TemplateStatus Propiedad ................................................................................. 86
IDPFPEnrollmentControl Interfaz ...................................................................................................87
IDPFPEnrollmentControl :: EnrolledFingersMask Propiedad ............................................................ 87
IDPFPEnrollmentControl :: MaxEnrollFingerCount Propiedad .......................................................... 89
IDPFPEnrollmentControl :: ReaderSerialNumber Propiedad ............................................................ 89
_IDPFPEnrollmentControlEvents Interfaz ...................................................................................... 91
_IDPFPEnrollmentControlEvents :: OnCancelEnroll Evento ............................................................. 91
_IDPFPEnrollmentControlEvents :: OnComplete Evento .................................................................. 91
_IDPFPEnrollmentControlEvents :: OnDelete Evento ....................................................................... 92
_IDPFPEnrollmentControlEvents :: OnEnroll Evento......................................................................... 93

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del vi
desarrollador
_IDPFPEnrollmentControlEvents :: OnFingerRemove Event93 ........................................
_IDPFPEnrollmentControlEvents :: OnFingerTouch Event94 ...........................................
_IDPFPEnrollmentControlEvents :: OnReaderConnect Event94 ......................................
_IDPFPEnrollmentControlEvents :: OnReaderDisconnect Event94 ..................................
_IDPFPEnrollmentControlEvents :: OnSampleQuality Event95 ........................................
_IDPFPEnrollmentControlEvents :: OnStartEnroll Event95 ...............................................
_IDPFPEventHandlerStatus Interface96.................................................................................
IDPFPEventHandlerStatus :: Estado Property96 ..............................................................
IDPFPFeatureExtraction Interface97 ......................................................................................
IDPFPFeatureExtraction :: CreateFeatureSet Method97 ..................................................
IDPFPFeatureExtraction :: FeatureSet Property97 ...........................................................
IDPFPFeatureSet Interface99 ................................................................................................
IDPFPFeatureSet :: Deserialize Method99 .......................................................................
IDPFPFeatureSet :: Serialize Method99 ...........................................................................
IDPFPReaderDescription Interface101 ...................................................................................
IDPFPReaderDescription :: FirmwareRevision Property101 .............................................
IDPFPReaderDescription :: HardwareRevision Property101.............................................
IDPFPReaderDescription :: Idioma Property101 ...............................................................
IDPFPReaderDescription :: ImpressionType Property102 ................................................
IDPFPReaderDescription :: ProductName Property102 ....................................................
IDPFPReaderDescription :: SerialNumber Property103 ....................................................
IDPFPReaderDescription :: SerialNumberType Property103 ............................................
IDPFPReaderDescription :: Tecnología Property104 ........................................................
IDPFPReaderDescription :: vendedor Property104 ...........................................................
IDPFPReadersCollection Interface106 ...................................................................................
IDPFPReadersCollection :: Lector Method106..................................................................
IDPFPReadersCollection :: Conde Property106 ...............................................................
IDPFPReadersCollection :: Item Property107 ...................................................................
IDPFPReadersCollection :: _ NewEnum Property107.......................................................
IDPFPSample Interface109 ....................................................................................................
IDPFPSample :: Deserialize Method109 ...........................................................................
IDPFPSample :: Serialize Method110 ...............................................................................
IDPFPSampleConversion Interface111 ..................................................................................
IDPFPSample :: ConvertToANSI381 Method111..............................................................
IDPFPSample :: ConvertToPicture Method111 .................................................................
IDPFPTemplate Interface113 .................................................................................................
IDPFPTemplate :: Deserialize Method113 ........................................................................
IDPFPTemplate :: Serialize Method114 ............................................................................
IDPFPVerification Interface115 ..............................................................................................
IDPFPVerification :: Activo Property115............................................................................

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del vii
desarrollador
IDPFPVerification :: FARRequested propiedad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
IDPFPVerification :: verificar el método. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
..
Interfaz IDPFPVerificationControl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
IDPFPVerificationControl :: Propiedad activo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
IDPFPVerificationControl :: ReaderSerialNumber propiedad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Interfaz _IDPFPVerificationControlEvents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
_IDPFPVerificationControlEvents :: OnComplete eventos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Interfaz IDPFPVerificationResult. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
IDPFPVerificationResult :: FARAchieved propiedad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
IDPFPVerificationResult :: verificado la propiedad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Enumeraciones. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
.....
DPFPCaptureFeedbackEnum tipo enumerado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
DPFPCapturePriorityEnum tipo enumerado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
DPFPEventHandlerStatusEnum tipo enumerado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
DPFPDataPurposeEnum tipo enumerado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
DPFPReaderImpressionTypeEnum tipo enumerado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
DPFPReaderTechnologyEnum tipo enumerado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
DPFPSerialNumberTypeEnum tipo enumerado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
DPFPTemplateStatusEnum tipo enumerado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

7 Interfaz de usuario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131


...........
DPFPEnrollmentControl objeto de interfaz de usuario. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
...
Registro de una huella digital. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
........
Eliminación de una plantilla de huellas dactilares. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
..............
DPFPVerificationControl objeto de interfaz de usuario. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
...
8 El desarrollo de aplicaciones de Citrix-consciente. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
................
9 La redistribución. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
.............
RTE \ carpeta de instalación. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
...........
Carpeta Redist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
.....
Documentación lector de huellas digitales. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
..........
Advertencias de hardware y normativas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Lector de huellas dactilares Manual de uso y mantenimiento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
.......
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del viii
desarrollador
U Ajuste de la velocidad Aceptar Falso. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
N ..............
A
Falso Tasa de aceptación (FAR). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
..............
Representación de la probabilidad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
.........
FAR solicitado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
...
Especificación de las FAR en Visual Basic. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
........
Especificación de la FAR en C ++. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
........

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del ix
desarrollador
Conseguido LEJOS ........................................................................................................................................149
Pruebas ............................................................................................................................................. 149

segundo
Plantilla de inscripción SDK Platinum Conversión ...................................................................... 150
Platinum SDK de inscripción Conversión plantilla para Microsoft Visual C ++ .................................. 150
Platinum SDK de inscripción Conversión plantilla para Visual Basic 6.0........................................... 152

Glosario ............................................................................................................................................. 153

Índice...................................................................................................................................... 156

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del ix
desarrollador
Introducción 1

Aquel Touch® para Windows SDK es una herramienta de desarrollo de software que permite a los
desarrolladores integrar la biometría de huellas digitales en una amplia serie de aplicaciones basadas
en Microsoft® Windows®, servicios y productos. La herramienta permite a los desarrolladores realizar
operaciones biométricos de huellas dactilares básica: la captura de una huella digital de un lector de
huellas digitales Digital Persona, la extracción de las características distintivas de la muestra de la
huella digital capturada, y almacenar los datos resultantes en una plantilla para su posterior
comparación de una huella digital presentado con una plantilla de huella digital existente .

Además, el One Touch para Windows SDK permite a los desarrolladores usar una variedad de
lenguajes de programación en una serie de entornos de desarrollo para crear sus aplicaciones. El
producto incluye documentación detallada y código de ejemplo que puede utilizarse para guiar a los
desarrolladores a manera rápida y eficiente producir adiciones biométricos de huellas digitales para
sus productos.

El One Touch para Windows SDK se basa en un legado de una década de la tecnología biométrica de
huellas digitales, siendo el conjunto más popular de las herramientas de desarrollo con el mayor
conjunto de usuarios inscritos de cualquier producto biométrico en el mundo. Debido a su popularidad,
el software de reconocimiento de la huella DigitalPersona® motor -con su alto nivel de precisión y
galardonado hardware U.are.U® lector de huellas digitales se han utilizado con la edad widest-, más
difíciles de huella digital demográfico de los usuarios en el mundo.

Thmi Uno TAy Fo Windows SDK decir ahs estado diseñado to autenticar usuarios en la Microsoft® Windows
Vista® y Microsoft® Windows® XP sistemas que se ejecutan en cualquiera de las plataformas
basadas en x86 operativo. El producto se utiliza con lectores de huellas digitales DigitalPersona en
una variedad de configuraciones útiles: periféricos USB independiente, módulos que están integrados
en plataformas de clientes, y los teclados.

También tenga en cuenta que el DigitalPersona One Touch ID SDK incluye el One Touch para
Windows RTE, la documentación y las muestras de .NET .NET, así; y se puede utilizar para
implementar un producto de la biometría en toda regla que abarca recogida de huellas dactilares, la
inscripción y la verificación. Le sugerimos que los desarrolladores OTID utilizan esta versión
incorporada de OTW.

Autenticación de huellas digitales en un equipo remoto


Este SDK incluye soporte transparente para la autenticación de huellas digitales a través de
Windows Terminal Services (incluyendo la conexión de escritorio remoto) ya través de una conexión
de Citrix a MetaFrame Presentation Server utilizando un cliente del paquete del cliente de Citrix
Presentation Server.

A través de escritorio remoto o una sesión de Citrix, se puede utilizar un lector de huellas digitales
locales para iniciar sesión en, y utilizar otras funciones instaladas, de un equipo remoto que ejecuta su
aplicación de huellas digitales habilitados.

Los siguientes tipos de clientes de Citrix son compatibles:


 Entorno de programas
 Agente de Program Neighborhood
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 1
desarrollador
 Web Cliente
Tenga en cuenta que para tomar ventaja de esta característica, su solicitud de huellas digitales
habilitados se debe ejecutar en el servidor de Terminal Services o Citrix, no en el cliente. Si está
desarrollando una aplicación de Citrix-conscientes, ver información adicional en elEl desarrollo de
aplicaciones de Citrix-aware capítulo en la página 141.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 2
desarrollador
Capítulo 1: Público objetivo
Introducción

Público objetivo
Thes guía es for desarrolladores wHo tener una working kONOCIMIENTO de la C ++ o METROicrosoft®
Visual Basic lenguaje de programación y el paradigma de RPC que se aplica a COM, o la familiaridad
con las bibliotecas de scripts modelo y tipo de automatización OLE.

Resumen del capítulo


Capítulo 1 Introducción (Este capítulo), describe la audiencia a la que está escrita esta guía; define las
tipográficos, y convenciones de nomenclatura de notación utilizadas en esta guía; cita una serie de
recursos que pueden ayudarle en el uso del One Touch para Windows SDK: COM / ActiveX Edition;
identifica los requisitos mínimos del sistema necesarios para ejecutar el One Touch para Windows
SDK: COM / ActiveX Edition; y enumera los productos DigitalPersona y plantillas de huellas digitales
soportados por el One Touch para Windows SDK: COM / ActiveX Edition.

Capítulo 2, inicio rápido, Proporciona una breve introducción a la One Touch para Windows SDK:
COM / ActiveX Edition mediante una de las aplicaciones de ejemplo que se proporcionan como parte
del SDK.

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 el disco duro.

Capítulo 4, Descripción general, Introduce One Touch para Windows SDK: COM / terminología y los
conceptos ActiveX Edition. Este capítulo también incluye diagramas y explicaciones del One Touch para
Windows flujo de trabajo típico: / ActiveX funciones API Edición COM utilizados para realizar las tareas
en los flujos de trabajo.

Capítulo 5, Referencia API para desarrolladores de Visual Basic, Define los componentes de la API
que se utilizan para el desarrollo de aplicaciones basadas en el One Touch para Windows: COM /
API Edición ActiveX en Microsoft Visual Basic.

Capítulo 6, referencia de API para C ++ Desarrolladores, Define los componentes de la API que se
utilizan para el desarrollo de aplicaciones basadas en el One Touch para Windows: COM / ActiveX
API Edición en C ++.

Capítulo 7, la interfaz de usuario, Describe la funcionalidad de las interfaces de usuario incluidos con
el registro de huellas dactilares y controles ActiveX de verificación de huellas dactilares.

Capítulo 9, Redistribución, Identifica los archivos que puede distribuir de acuerdo con el Contrato de
licencia de usuario final (EULA) y enumera las funcionalidades que necesita para proporcionar a los
usuarios finales cuando se desarrolla productos basados en el One Touch para Windows: COM / API
Edición de ActiveX.

Apéndice A, Configuración de la Tasa de falsos Aceptar, Proporciona información acerca de la


determinación y el uso de valores específicos para la FAR y evaluar y probar los valores obtenidos.

Apéndice B, Platinum SDK de inscripción plantilla Conversión, Contiene código de ejemplo para la
conversión de las plantillas de registro Platinum SDK para su uso con el One Touch para Windows
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 3
desarrollador
Capítulo 1: Público objetivo
Introducción
SDK: COM / ActiveX Edition.

Un glosario y un índice también se incluyen para su referencia.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 4
desarrollador
Capítulo 1: Convenciones del
Introducción documento

Convenciones del documento


Esta sección define los, y convenciones de nomenclatura tipográficos notación utilizadas en esta guía.

Símbolos convencionales
Las siguientes convenciones de notación se utilizan en esta guía:

NOTA: Las notas proporcionan recordatorios suplementarios, consejos o sugerencias.

IMPORTANTE: anotaciones importantes contienen información importante sobre el comportamiento del


sistema, incluyendo problemas o los efectos secundarios que pueden ocurrir en
situaciones específicas.

Convenciones tipográficas
Las siguientes convenciones tipográficas se utilizan en esta guía:

Tipo de Propósito Ejemplo


letra
Negrita Se utiliza para las pulsaciones de Haga clic en Registro de huellas dactilares.
teclado y los elementos del cuadro de
Aparece el cuadro de diálogo de huellas digitales.
diálogo y ventanas, y para indicar los
tipos de datos Cuerda que especifica una serie lector de
huellas digitales número

mensajero Se utiliza para indicar el código de Cuando se devuelve SampleQualityGood, la


negrita programación informática OnComplete evento se dispara.
Deserializa un objeto de datos devuelto por el
IDPFPData :: Serialize método.

Cursiva Se utiliza para dar énfasis o para introducir Esta sección incluye ilustraciones de huella digital
nuevos términos típico inscripción y verificación de huellas dactilares
flujos de trabajo. (énfasis)
Si está viendo este documento en línea, al
hacer clic en el texto en cursiva también Una huella digital es una impresión de las crestas
puede activar un enlace de hipertexto a en la piel de un dedo. (nuevo término)
otras áreas en esta guía o de direcciones Consulte Instalación del SDK en la página 8.
URL. (enlace a la página de título y)

Convenciones de nombres
DPFP es sinónimo de DigitalPersona de la huella digital.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 5
desarrollador
Capítulo 1: Recursos
Introducción adicionales

Recursos adicionales
Tú puede hacer referencia a los recursos en esta sección para ayudarle a utilizar el One Touch
para Windows SDK: COM / ActiveX Edition.

Documentación relacionada

Tema Documento

reconocimiento de huellas digitales, incluyendo la El Libro Blanco DigitalPersona: Guía de


historia y fundamentos de la identificación de reconocimiento de la huella (huella digital Guide.pdf)
huellas dactilares y las ventajas del reconocimiento se encuentra en la carpeta Docs en el One Touch para
de la huella del motor de DigitalPersona el paquete de software de Windows, y no se instala
automáticamente en el ordenador como parte del
proceso de instalación.
Información de última hora noticias sobre el producto Los archivos Readme.txt previstas en el directorio
raíz del paquete de software SDK, así como en
algunos subdirectorios

Recursos en línea

Nombre del Sitio Web URL

DigitalPersona Developer Forum Conexión para peer-to http://www.digitalpersona.com/webforums/


la interacción entre pares entre DigitalPersona
Desarrolladores
Las últimas versiones de los productos de software http://www.digitalpersona.com/support/downloads/
DigitalPersona software.php

Requisitos del sistema


En esta sección se enumeran los requisitos mínimos de software y hardware necesarios para ejecutar
el One Touch para Windows SDK: COM / ActiveX Edition.
 procesador basado en x86 o mejor
 versiones de 32 bits y 64 bits de Microsoft® Windows® XP,; Microsoft® Windows® XP Embedded, la
versión de 32 bits 1; o Microsoft® Windows Vista®, versiones de 32 bits y 64 bits
 conector USB en el equipo en el lector de huellas digitales debe ser conectado

1. Una lista de dependencias DLL para la instalación de la aplicación en Microsoft Windows XP Embedded, One Touch para Windows XPE
Dependencies.xls, es ubicado en la carpeta de documentos en el paquete de software SDK.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 6
desarrollador
Capítulo 1: Productos de hardware soportadas
Introducción DigitalPersona

Productos de hardware soportadas DigitalPersona


El One Touch para Windows SDK: COM / ActiveX Edition es compatible con el siguiente hardware
DigitalPersona productos:
 DigitalPersona U.are.U 4000B / 4500 o posteriores lectores de huellas digitales y módulos
 Teclado Digital Persona U.are.U de huellas dactilares

Compatibilidad plantilla de huellas dactilares


plantillas de huellas digitales producidos por todas las ediciones del One Touch para Windows SDK
también son compatibles con los siguientes SDK DigitalPersona:
 oro SDK
 SDK de Oro CE
 One Touch SDK para Linux, todas las distribuciones

NOTA: Las plantillas de inscripción Platinum SDK deben ser convertidos a un formato compatible para trabajar
con estos SDK.
Ver Apéndice B en la página 150 para el código de ejemplo que convierte las plantillas SDK Platinum para
este formato.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 7
desarrollador
Rápido comienzo 2

En este capítulo se ofrece una breve introducción a la One Touch para Windows SDK: COM / ActiveX
Edition mediante una de las aplicaciones de ejemplo que se proporcionan como parte del One Touch
para Windows SDK.

La aplicación es un proyecto de Microsoft Visual Basic 6, que muestra la funcionalidad de las interfaces de
usuario incluido en los objetos componentes DPFPEnrollmentControl y DPFPVerificationControl. Las
interfaces de usuario se describen con más detalle enDPFPEnrollmentControl objeto de interfaz de usuario
en la página 131 y DPFPVerificationControl objeto de interfaz de usuario en la página 140.

Conceptos rápidas
Las siguientes definiciones le ayudarán a comprender el propósito y la funcionalidad de la aplicación
de ejemplo que se describe en esta sección.

Inscripción-El proceso de captura de la huella digital de una persona cuatro veces, la extracción de
las características de las huellas dactilares, la creación de una plantilla de huellas dactilares, y el
almacenamiento de la plantilla para la comparación posterior.

Verificación-El proceso de comparación de una huella digital capturada a una plantilla de huella digital
para determinar si las dos coinciden.

Unenrollment-El proceso de eliminación de una plantilla de huella digital asociada a una huella
dactilar previamente inscrito.

Para descripciones adicionales de estos procesos, ver Capítulo 4 en la página 17.

Instalación del software


Antes de poder utilizar la aplicación de ejemplo, debe instalar el One Touch para Windows SDK: COM /
ActiveX Edición, que incluye el DigitalPersona One Touch para Windows Runtime Environment
(RTE).

Para instalar el One Touch para Windows SDK: COM / ActiveX Edición
1. En la carpeta SDK en el paquete de software SDK, abra el archivo Setup.exe y, a continuación, haga clic en
Siguiente.

2. Siga las instrucciones de instalación que aparecen.

3. Reinicia tu computadora.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 8
desarrollador
Capitulo 2: Inicio Conectar el lector de huellas
rápido digitales

Conectar el lector de huellas digitales


Conectar el lector de huellas digitales en el conector USB en el sistema donde se ha instalado el SDK.

Uso de la aplicación de la muestra


Mediante la realización de los ejercicios de esta sección,
 Iniciar la aplicación de ejemplo
 Registrar una huella digital
 Verificar una huella digital
 Anular inscripción (eliminar) una huella digital
 Salir de la aplicación de la muestra

Para iniciar la aplicación de ejemplo

1. Abra el archivo UIVBDemo.exe -


Se encuentra en la <carpeta de destino> One Touch SDK \ COM-
ActiveX \ Ejemplos \ carpeta de Visual Basic 6 \ UI de apoyo.
2. Aparece el cuadro de diálogo VB demostración.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 9
desarrollador
Capitulo 2: Inicio Uso de la aplicación de la
rápido muestra

Registro de una huella digital consiste en el escaneo de su huella digital cuatro veces utilizando el lector de
huellas digitales.

Para registrar una huella digital


1. En el cuadro de diálogo VB Demo, haga clic incluir
huellas digitales. Aparece el cuadro de diálogo de

huellas digitales.

2. En la derecha “mano”, haga clic en el dedo índice.


Aparece una segunda ventana de diálogo de huellas digitales.

3. Uso del lector de huellas digitales, escanear su huella digital índice derecho.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 10
desarrollador
Capitulo 2: Inicio Uso de la aplicación de la
rápido muestra

4. Repita el paso 3 hasta que la inscripción fue aparece mensaje de éxito.

5. Haga clic en Cerrar.

Para verificar una huella digital


1. En el cuadro de diálogo VB Demo, haga clic en
Verificar la huella digital. Aparece el cuadro de

diálogo Verificar tu identidad.

2. Uso del lector de huellas digitales, escanear su huella digital índice derecho.
En el cuadro de diálogo Verificar tu identidad, una marca verde aparece sobre la huella digital, lo
que indica que su huella digital se verificó.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 11
desarrollador
Capitulo 2: Inicio Uso de la aplicación de la
rápido muestra

3. Uso del lector de huellas digitales, escanear su huella digital medio derecho.
En el cuadro de diálogo Verificar tu identidad, un signo de interrogación rojo aparece sobre la
huella digital, lo que indica que su huella digital no se verificó.

4. Haga clic en Cerrar.

Para anular la inscripción (eliminar) una huella digital


1. En el cuadro de diálogo VB Demo, haga clic incluir huellas digitales.
Aparece el cuadro de diálogo de huellas digitales, lo que indica que se ha inscrito a su
índice de la huella digital correcta.

2. A la derecha “mano”, haga clic en el dedo índice verde.


Aparece un cuadro de mensaje, pidiéndole que verifique la unenrollment (supresión).

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 12
desarrollador
Capitulo 2: Inicio Uso de la aplicación de la
rápido muestra

3. En el cuadro de mensaje, haga clic en Sí.


El dedo índice derecho ya no está verde, lo que indica que la huella digital asociada a ese dedo
no está inscrito, o ha sido suprimido.

Para salir de la aplicación


 En el cuadro de diálogo VB Demo, haga clic en Salir.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 13
desarrollador
Instalación 3

Este capítulo contiene instrucciones para instalar los diversos componentes del One Touch para
Windows SDK: COM / ActiveX Edición e identifica los archivos y carpetas que están instalados en el
disco duro.

Los siguientes dos instalaciones se encuentran en el paquete de software SDK:


 SDK, que se utiliza en el desarrollo de su aplicación. Esta instalación se encuentra en la carpeta SDK.
 RTE (entorno de ejecución), que debe proporcionar a los usuarios finales para implementar el
One Touch para Windows SDK: / componentes COM ActiveX Edition. Esta instalación se
encuentra en la carpeta RTE. (RTE La instalación también se incluye en la instalación SDK).

Instalación del SDK


NOTA: Todas las instalaciones de compartir los archivos DLL y el archivo DPHostW.exe que se instala con el / C
edición C ++.
Archivos adicionales específicos del producto se proporcionan para otras ediciones.

Para instalar el One Touch para Windows SDK: COM / ActiveX Edition para sistemas operativos de 32 bits
1. En la carpeta SDK en el paquete de software SDK, abra el archivo Setup.exe y, a continuación, haga clic en
Siguiente.

2. Siga las instrucciones de instalación que aparecen.

3. Reinicia tu computadora.

Para instalar el One Touch para Windows SDK: COM / ActiveX Edition para sistemas operativos de 64 bits
1. En la carpeta SDK \ x64 en el paquete de software SDK, abra el archivo Setup.exe y, a continuación, haga
clic en Siguiente.

2. Siga las instrucciones de instalación que aparecen.

3. Reinicia tu computadora.

Mesa 1 describe los archivos y carpetas que se instalan en la carpeta <carpeta de destino> en el
disco duro para las instalaciones de 32 bits y 64 bits. Los archivos y carpetas listos para el consumo,
que se describen enMesa 2 en la página 14 para la instalación de 32 bits y en la Tabla 3 en la página
15 para la instalación de 64 bits, también están instalados en su disco duro.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 12
desarrollador
Capítulo 3: Instalación del entorno de tiempo de
Instalación ejecución (RTE)

Tabla 1. One Touch para Windows SDK: COM / ActiveX instalados los archivos y carpetas Edición

Carpeta Expediente Descripción

One Touch SDK \ COM- One Touch para Windows DigitalPersona One Touch para el SDK de
ActiveX \ Docs SDK COM-ActiveX Windows: Guía del Desarrollador COM /
desarrollador Guide.pdf ActiveX Edición

One Touch SDK \ Esta carpeta contiene un ejemplo de Microsoft Visual Basic 6 proyecto que
COM- ActiveX \ muestra cómo utilizar el One Touch para Windows: COM / API Edición de
Samples \ VB6 \ ActiveX para realizar la inscripción de huellas digitales y verificación de
Muestra de huellas dactilares.
inscripción
One Touch SDK \ Esta carpeta contiene un proyecto de ejemplo de Microsoft Visual Basic 6, que
COM- ActiveX \ demuestra la funcionalidad de las interfaces de usuario incluido en los objetos
Samples \ VB6 \ componentes DPFPEnrollmentControl y DPFPVerificationControl del One
Support interfaz de Touch para Windows: COM / API Edición de ActiveX.
usuario

Instalación del entorno de tiempo de ejecución (RTE)


Cuando se desarrolla un producto basado en el One Touch para Windows SDK: COM / ActiveX
Edition, es necesario proporcionar los redistributables a sus usuarios finales. Estos archivos están
diseñados y autorizados para su uso con la aplicación. Puede incluir los archivos de instalación
ubicados en la RTE \ carpeta de instalación de la aplicación o puede incorporar las redistributables
directamente en su instalador. También puede utilizar los módulos de combinación ubicados en la
carpeta Redist en el paquete de software SDK para crear su propio instalador MSI. (VerRedistribución
en la página 142 para condiciones de licencia.)

Si ha creado una aplicación basada en el One Touch para Windows: COM / ActiveX Edition API que
no incluye un instalador, los usuarios finales deben instalar el One Touch para Windows: COM /
ActiveX Edición Runtime Environment para ejecutar su aplicación.

Para instalar el One Touch para Windows: ActiveX Edición listos para el consumo para los sistemas
operativos COM / 32 bits
1. En la carpeta de RTE en el paquete de software SDK, abra el archivo Setup.exe.

2. Siga las instrucciones de instalación que aparecen.

Tabla 2 identifica los archivos que se instalan en el disco duro.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 13
desarrollador
Capítulo 3: Instalación del entorno de tiempo de
Instalación ejecución (RTE)

Tabla 2. One Touch para Windows: COM / ActiveX Edición RTE instalado los archivos y carpetas, la instalación
de 32 bits

Carpeta Expediente Descripción

<Carpeta de destino> DPCOper2.dll DLL y archivo ejecutable utilizado por la


\Compartimiento DPDevice2.dll totalidad de la One Touch para las API de
Windows
DPDevTS.dll
DpHostW.exe
DPmsg.dll
DPMux.dll
DpSvInfo2.dll
DPTSClnt.dll
DPCrStor.dll

<Carpeta de destino> DPFPShrX.dll DLL utilizados por el One Touch para


\Bin \ COM-ActiveX Windows: COM / Edición de ActiveX API
DPFPDevX.dll
DPFPEngX.dll
DPFPCtlX.dll

<Sistema de carpetas> DPFPApi.dll DLL utilizados por todo el One Touch para
Windows SDK API
DpClback.dll
dpHFtrEx.dll
dpHMatch.dll
DPFpUI.dll

A instalar el One Touch para Windows: COM / ActiveX Edición Runtime Environment para operativo
de 64 bits sistemas
1. En la carpeta RTE \ x64 en el paquete de software SDK, abra el archivo Setup.exe.

2. Siga las instrucciones de instalación que aparecen.

Mesa 3 identifica los archivos que se instalan en el disco duro para las versiones de 64 bits de los
sistemas operativos compatibles.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 14
desarrollador
Capítulo 3: Instalación del entorno de tiempo de
Instalación ejecución (RTE)

Tabla 3. One Touch para Windows: COM / ActiveX Edición RTE instalado los archivos y carpetas, la instalación
de 64 bits

Carpeta Expediente Descripción

<Carpeta de destino> DPCOper2.dll DLL y archivo ejecutable utilizado por la


\Compartimiento DPDevice2.dll totalidad de la One Touch para las API de
Windows
DPDevTS.dll
DpHostW.exe
DPMux.dll
DpSvInfo2.dll
DPTSClnt.dll
DPCrStor.dll

<Carpeta de destino> \Bin \ DPmsg.dll DLL utilizada por la totalidad de la


x64 One Touch para las API de Windows

<Carpeta de destino> \Bin \ DPFPShrX.dll DLL de 32 bits utilizados por el One Touch para
ActiveX Windows: COM / ActiveX Edición API
DPFPEngX.dl
l
DPFPDevX.dl
l
DPFPCtlX.dll
<Carpeta de destino> \Bin \ DPFPShrX.dll DLL de 64 bits utilizados por el One Touch para
ActiveX \ x64 Windows: COM / ActiveX Edición API
DPFPEngX.dll
DPFPDevX.dll
DPFPCtlX.dll

<Sistema de carpetas> DPFPApi.dll DLL de 32 bits utilizados por todo el One


Touch para las API de Windows
DpClback.dll
dpHFtrEx.dll
dpHMatch.dll
DPFpUI.dll

<Carpeta System64> DPFPApi.dll DLL de 64 bits utilizados por todo el One


DpClback.dll Touch para las API de Windows

dpHFtrEx.dll
dpHMatch.dll
DPFpUI.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 15
desarrollador
Capítulo 3: Instalación y desinstalación de la RTE
Instalación silencio

Instalación y desinstalación de la RTE silencio


El One Touch para el paquete de software de Windows SDK contiene un archivo por lotes,
InstallOnly.bat, que se puede utilizar para instalar silenciosamente la RTE. Además, puede modificar el
archivo para instalar de forma selectiva las diversas características de la evaluación en tiempo real.
Consulte el archivo de instrucciones.

El paquete de software SDK también contiene un archivo, UninstallOnly.bat, que se puede utilizar para desinstalar
silenciosamente la RTE.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 16
desarrollador
Visión general 4

En este capítulo se presenta un solo toque para Windows SDK: conceptos / COM ActiveX Edition y
terminología. (Para más detalles sobre el tema de la biometría de huellas digitales, consulte el “Libro
Blanco DigitalPersona: Guía de reconocimiento de la huella” que se incluye en el One Touch para el
paquete de software de Windows SDK.) En este capítulo también incluye diagramas y explicaciones
del One Touch para el flujo de trabajo típico ventanas: / ActiveX funciones API Edición COM utilizados
para realizar las tareas en los flujos de trabajo.

Sistema biométrico
Un sistema biométrico es un método automático de identificación de una persona basándose en los
rasgos físicos y / o de comportamiento únicas de la persona, como una huella digital o un patrón del
iris, o una firma manuscrita o la voz. identificadores biométricos son
 Universal
 Distintivo
 Persistente (suficientemente inalterable en el tiempo)
 Coleccionable

Los sistemas biométricos han convertido en un componente esencial de las soluciones eficaces de
reconocimiento de persona porque los identificadores biométricos no se pueden compartir o fuera de
lugar y es natural que representan la identidad corporal de un individuo. formas sustitutivas de la
identidad, tales como contraseñas (comúnmente utilizados en el control de acceso lógico) y tarjetas de
identidad (se utilizan con frecuencia para el control de acceso físico), no proporcionan este nivel de
autenticación que valida fuertemente el enlace al usuario autorizado real.

reconocimiento de huellas dactilares es el sistema biométrico más popular y madura utilizados en la


actualidad. Además de cumplir los cuatro criterios anteriormente, los sistemas de reconocimiento de
huellas dactilares se desempeñan bien (es decir, que son precisas, rápidas, y robusto), son
públicamente aceptable, y que son difíciles de eludir.

Huella dactilar
Una huella digital es una impresión de las crestas en la piel de un dedo. UNA sistema de reconocimiento
de huellas dactilares utiliza las características distintivas y persistentes de las crestas, también conocida
como características de huellas dactilares, para distinguirun dedo (o persona) de otro. El One Touch
para Windows SDK: COM / ActiveX edición incorpora laDigitalPersona Fingerprint Recognition Engine
(Motor), Que utiliza metodologías tradicionales y modernos de reconocimiento de huella digital para
convertir estas características de huellas digitales en un formato que es compacto, distintivo y
persistente. El motor utiliza las características de huellas dactilares, convertidos, o extraídos en
comparación y toma de decisiones para proporcionar reconocimiento personal fiable.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 17
desarrollador
Capítulo 4: Visión El reconocimiento de
general huellas dactilares

El reconocimiento de huellas dactilares


El sistema de reconocimiento de huellas digitales DigitalPersona utiliza los procesos de registro de huellas
dactilares y huellas dactilares verificación, que se ilustran en el diagrama de bloques en La Figura 1 en
la página 19. Algunas de las tareas en estos procesos son realizados por elLector de huellas dactilares y
su conductor; algunos se llevan a cabo utilizando One Touch para Windows: COM / ActiveX funciones
API de edición, que utilizan el motor; y algunos son proporcionados por la aplicación de software y / o
hardware.

Inclusión de huellas digitales


registro de huellas dactilares es el proceso inicial de la recogida de de datos de huellas dactilares desde un
inscrita y almacenar los datos resultantes como una plantilla de huellas dactilares para su posterior
comparación. El siguiente procedimiento describe la inscripción típico de huellas dactilares. (Pasos
precedidos por un asterisco no se realizan por el One Touch para Windows SDK:. COM / ActiveX
Edition)

1. * Obtener identificador de la persona inscrita (Asunto Identifier).

2. Capturar la huella dactilar de la persona inscrita con el lector de huellas digitales.

3. extraer el conjunto de características de huellas digitales para el propósito de la inscripción de la muestra de la


huella digital.

4. Repita los pasos 2 y 3 hasta que haya suficiente característica huella digital fija para crear una plantilla de
huellas dactilares.

5. Crear una plantilla de huellas dactilares.

6. * Asociar la plantilla de huellas dactilares con el inscrito a través de un identificador de tema,


como un nombre de usuario, dirección de correo electrónico o número de empleado.

7. * Guarde la plantilla de huellas dactilares, junto con el identificador de Asunto, para su posterior
comparación.
plantillas de huellas digitales se pueden almacenar en cualquier tipo de depósito que elija, tales
como huella dactilar dispositivo de captura, Una tarjeta inteligente o una base de datos local o
central.

La verificación de huellas dactilares


verificación de huellas dactilares es el proceso de comparar los datos de huellas dactilares a la plantilla
de la huella digital producida en la inscripción y decidir si ambas coinciden. El siguiente procedimiento
describe la verificación de huellas dactilares típico. (Pasos precedidos por un asterisco no se realizan
por el One Touch para Windows SDK:. COM / ActiveX Edition)

1. * Sujeto obtener el identificador de la persona a ser verificada.

2. Capturar una muestra de la huella dactilar usando el lector de huellas digitales.

3. Extraer una característica de huellas digitales establecido para el propósito de la verificación de la muestra
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 18
desarrollador
Capítulo 4: Visión El reconocimiento de
generalde la huella digital. huellas dactilares

4. * Recuperar la plantilla de huella digital asociada con el identificador Asunto de su repositorio.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 19
desarrollador
Capítulo 4: Visión Los falsos positivos y falsos
general negativos

5. realizar una uno-a-uno la comparación entre el conjunto de características de huellas dactilares y


la plantilla de huellas dactilares, y tomar una decisión de partido o no coincidencia.

6. * Ley de la decisión en consecuencia, por ejemplo, abrir la puerta de un edificio para un partido, o
denegar el acceso al edificio para un no-partido.

Inclusión de huellas
digitales
Obtener Identificador
Asunto

Crear conjuntos Identificador de la


las huellas digitales crear plantilla
de tienda y Asunto
de captura
características

La verificación de
huellas dactilares
Recuperar la plantilla y
Obtener Identificador
el identificador de
Asunto
Asunto

Crear conjunto Comparar y Use las


Captura de huellas
de tomar decisiones
dactilares
característica decisiones de aplicación

Leyenda
Realizado por One Touch para Windows SDK: C / C
++ No realizado por One Touch para Windows SDK:
C / C ++

Figura 1. sistema de reconocimiento de huellas digitales DigitalPersona

Los falsos positivos y falsos negativos


Los sistemas de reconocimiento de huellas digitales ofrecen muchas ventajas seguridad y comodidad frente
a los métodos tradicionales de reconocimiento. Sin embargo, son esencialmente los sistemas de
reconocimiento de patrones que inherentemente ocasionalmente hacen ciertos errores, porque no hay
dos impresiones del mismo dedo son idénticos. Durante la verificación, a veces una persona que está
inscrito legítimamente es rechazada por el sistema (una decisión negativa falsa), y, a veces una
persona que no está inscrito es aceptada por el sistema (una decisión falso positivo).

La proporción de decisiones falsos positivos se conoce como el tasa de aceptar falsas (FAR), y la
proporción de decisiones falsos negativos se conoce como el tasa de rechazo falso (FRR). En los sistemas
de reconocimiento de huellas dactilares, las FAR y FRRse negocian unos contra otros, es decir, menor
es la FAR, mayor será la FRR, y más alta la FAR, menor es la FRR.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 20
desarrollador
Capítulo 4: Visión Los flujos
general de trabajo

Un One Touch para Windows: Edición función API / COM ActiveX le permite establecer el valor de las
FAR, también conocido como el nivel de seguridad, Para dar cabida a las necesidades de su aplicación.
En algunas aplicaciones, tales como un sistema de control de acceso a un sitio altamente confidencial
o base de datos, un menor FAR se requiere. En otras aplicaciones, tales como un sistema de entrada
a un parque temático de entretenimiento, la seguridad (que reduce el fraude billete cometido por una
pequeña fracción de los clientes mediante el intercambio de sus billetes de entrada) no puede ser tan
importante como la accesibilidad para todos los clientes, y puede ser preferible disminuir la FRR a
expensas de un aumento de la FAR.

Es importante recordar que la precisión del sistema de reconocimiento de huellas dactilares es en gran
parte debido a la calidad de la huella dactilar. Las pruebas con grupos considerables de personas
durante un período prolongado ha demostrado que la mayoría de las personas tienen múltiples
funciones, las huellas digitales de alta calidad. Estas huellas digitales es casi seguro que serán
reconocidos con precisión por el motor de reconocimiento de huellas digitales DigitalPersona y
prácticamente nunca se acepta de manera falsa o falsamente rechazada. El sistema de
reconocimiento de huellas digitales DigitalPersona está optimizado para reconocer las huellas digitales
de baja calidad. Sin embargo, un número muy pequeño de personas puede tener que intentar una
segunda o incluso una tercera vez para obtener una lectura precisa. Sus huellas dactilares pueden ser
difíciles de verificar, ya que están bien gastados del trabajo manual o tener rebordes ilegibles.

Los flujos de trabajo


Típico flujos de trabajo se presentan en esta sección para las siguientes operaciones:
 registro de huellas dactilares
 registro de huellas dactilares con el apoyo de IU
 verificación de huellas dactilares
 verificación de huellas dactilares con el apoyo de IU
 Huella digital serialización de objetos de datos y deserialización

NOTA: Pasos precedido por dos asteriscos (**) se realiza por un lector de huellas digitales, y los pasos
precedidos de un asterisco (*) Son realizadas por una aplicación. “Nn página VB” y “C ++ nn
página” indican las referencias de página para la referencia de la API de Visual Basic y C para
la referencia de la API ++, respectivamente.

Inclusión de huellas digitales de flujo de trabajo


Esta sección contiene un flujo de trabajo típico para la realización de registro de huellas dactilares.
El flujo de trabajo se ilustra en laFigura 2 y es seguido por explicaciones del One Touch para
Windows: / ActiveX funciones API Edición COM utilizados para realizar las tareas del flujo de trabajo.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 21
desarrollador
Capítulo 4: Visión Inclusión de huellas digitales de
general flujo de trabajo

Captura de la muestra de la
huella digital
Implementar controlador
Crear un objeto de eventos para Establecer las propiedades
DPFPCapture notificaciones de DPFPCapture
eventos Prioridad, ReaderSeriaTNumber

Iniciar la captura de muestras Recibe OnCompTete


de huellas digitales de lector Captura de la huella dactilar evento con objeto
de huellas digitales de la muestra DPFPSampTe
StartCapture método

Detener la captura
de muestras de
huellas digitales
StopCapture método

Extracción de características de
huellas dactilares
Crear un objeto utilizando
Crear un objeto DPFPFeatureSet
DPFPFeatureExtraction DataPurposeEnroTTment
CreateFeatureSet método

Recibir
DPFPFeatureSet

Inclusión de huellas digitales


Realizar la función del
Crear sistema de registro de
DPFPEnroTTment objeto huellas dactilares y regresar
objeto DPFPTempTate
Agrega características método

plantilla de huella clara y


Recibir establecer TempTateStatus a
DPFPTempTate objeto TempTateStatusUnknown
CTEAR método

Serializa objeto serializado almacenar


DPFPTempTate datos de la plantilla de
para el huellas dactilares en el
subsistema de

Leyenda
s One Touch para Windows SDK: COM /
e
ActiveX Paso opcional

Aplicación (no es parte de SDK) lector

de huellas dactilares

Figura 2. flujo de trabajo de registro de huellas dactilares Típica

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 22
desarrollador
Capítulo 4: Visión Inclusión de huellas digitales de
general flujo de trabajo

Captura de la muestra de la huella digital


1. * Crear una instancia de una DPFPCapture objeto (VB página 36, C ++ página 78).

2. * Implementar un controlador de eventos para DPFPCaptureEvents notificaciones de eventos (VB página


38, C ++
página 81).

3. Opcionalmente, establecer el Prioridad y ReaderSerialNumber propiedades (VB página 36 y página


37; C ++
página 78 y página 79).

4. Iniciar la captura de muestras de huellas digitales del lector de huellas digitales llamando al StartCapture
método (VB página 36, C ++ página 79).

5. ** capturar una muestra de la huella digital de un lector de huellas digitales.

6. *Recibe el OnComplete evento con un objeto DPFPSample cuando la muestra de huella


digital es capturado con éxito por el lector de huellas digitales (VB página 38, C ++ página
81).

7. * Pase el objeto DPFPSample al método DPFPFeatureExtraction. (Véase el paso 2 en la


siguiente sección).

8. Detener la captura de muestras de huellas digitales llamando al StopCapture método (VB página 36, C ++
página 80).

Extracción de características de huellas dactilares


1. * Crear una instancia de un objeto DPFPFeatureExtraction (VB página 51, C ++ página 97).

2. Crear DPFPFeatureSet objetos llamando al método CreateFeatureSet usando el


DataPurposeEnrollment valor y pasando un objeto DPFPSample desde el paso 7 de la sección
anterior (VB página 52, C ++ página 97).

3. * Pasar los objetos DPFPFeatureSet creados en el paso anterior con el método addFeatures.

Inclusión de huellas digitales


1. * Crear una instancia de una DPFPEnrollment objeto (VB página 41, C ++ página 85).

2. Realizar la función del sistema de registro de huellas dactilares mediante una llamada al
Agrega características método y pasando los objetos DPFPFeatureSet (VB página
41, C ++ página 85).
Cuando la propiedad TemplateStatus devuelve el valor TemplateStatusReady, una
DPFPTemplate objeto se crea (VB página 42, C ++ página 86).

3. * Recibe el objeto DPFPTemplate.

4. Serializar el objeto DPFPTemplate (ver La serialización de un objeto de datos de huellas dactilares en la página
32).

5. * Almacenar los datos de la plantilla de huella digital en serie en un subsistema de almacenamiento de datos
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 23
desarrollador
Capítulo 4: Visión Inclusión de huellas digitales de
generalde huellas dactilares. flujo de trabajo

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 24
desarrollador
Capítulo 4: Visión Inclusión de huellas digitales con
general soporte para la interfaz de usuario

6. Desactive la plantilla de huellas dactilares y establecer el valor de TemplateStatus a


TemplateStatusUnknown mediante una llamada al método Clear (VB página 41, C ++ página 85).

Inclusión de huellas digitales con soporte para la interfaz de usuario


Esta sección contiene dos flujos de trabajo típicas para la realización de registro de huellas
dactilares: una para inscribir una huella dactilar y una para anulado el registro (borrado) en una
plantilla de huella dactilar. Los flujos de trabajo se ilustran enfigura 3 y Figura 4 y son seguidos por
explicaciones del One Touch para Windows: / ActiveX funciones API Edición COM utilizados para
realizar las tareas en los flujos de trabajo.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 25
desarrollador
Capítulo 4: Visión Inclusión de huellas digitales con
general soporte para la interfaz de usuario

Registro de una huella digital

Control de registro de huellas dactilares - registrar


la huella
Implementar controlador de eventos
crear DPFPEnroTTmentControT para notificaciones de eventos
objeto DPFPEnroTTmentControTEvents

Establecer Establecer DPFPEnroTTmentControT


DPFPEnroTTmentControT propiedades
propiedad MaxEnroTTFingerCount, ReaderSeriaTNumber
EnroTTedFingersMask

Recibe evento con OnEnroTT


Captura de la huella dactilar
DPFPTempTate objeto
de la muestra

serializar DPFPTempTate Almacenar datos de huellas digitales


objeto para el en serie
almacenamiento en el subsistema de almacenamiento

Almacenar nueva
EnroTTedFingersMask
en el subsistema de almacenamiento

Establecer el valor apropiado para


DPFPEventHandTerStatus objeto

Leyenda

s One Touch para Windows SDK: COM /


e ActiveX Paso opcional

Aplicación (no es parte de SDK) lector


de huellas dactilares

Figura 3. registro de huellas dactilares típico con el flujo de trabajo de soporte de interfaz de usuario:
Registro de una huella digital

1. * Crear una instancia de una DPFPEnrollmentControl objeto (VB página 43, C ++ página 87).

2. * Implementar un controlador de eventos para DPFPEnrollmentControlEvents notificaciones de


eventos (VB
página 46, C ++ página 91).

3. Selecciona el EnrolledFingersMask propiedad (VB página 43, C ++ página 87).

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 26
desarrollador
Capítulo 4: Visión Inclusión de huellas digitales con
general soporte para la interfaz de usuario

4. Opcionalmente, establecer el MaxEnrollFingerCount y propiedades ReaderSerialNumber (VB página 44


y página 45; C ++página 89 y página 89).

5. ** capturar una muestra de la huella digital de un lector de huellas digitales.

6. *Recibe el OnEnroll evento y el objeto DPFPTemplate (VB página 47, C ++ página 93).

7. serializar el objeto DPFPTemplate (ver La serialización de un objeto de datos de huellas dactilares en la página
32).

8. * Almacenar los datos de plantilla de huella digital en serie y el nuevo valor de la


EnrolledFingersMask en un subsistema de almacenamiento de datos de huellas dactilares.

9. * Establecer el valor apropiado para el objeto DPFPEventHandlerStatus (VB página 71, C ++ página 126).

Anulado el registro (Borrado) una plantilla de huella dactilar

Control de registro de huellas dactilares - huellas dactilares Anular inscripción


Implementar controlador de
crear DPFPEnroTTmentControT eventos para
DPFPEnroTTmentControTEvents
objeto
notificaciones de eventos

Establecer Recibe caso OnDeTete


DPFPEnroTTmentControT con valor de índice
propiedad

Eliminar plantilla de huella


Almacenar nueva
digital apropiado desde el
subsistema de EnroTTedFingersMask
almacenamiento de datos de

Establecer el valor apropiado para


DPFPEventHandTerStatus objeto

Leyenda
One Touch para Windows SDK: COM /

ActiveX Paso opcional

Aplicación (no es parte de SDK)

Figura 4. registro de huellas dactilares típico con el flujo de trabajo de soporte de interfaz de usuario:
Anulando la inscripción una plantilla de huella dactilar

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 27
desarrollador
Capítulo 4: Visión La verificación de
general huellas dactilares

1. * Crear una instancia de una DPFPEnrollmentControl objeto (VB página 43, C ++ página 87).

2. * Implementar un controlador de eventos para DPFPEnrollmentControlEvents notificaciones de


eventos (VB
página 46, C ++ página 91).

3. Selecciona el EnrolledFingersMask propiedad (VB página 43, C ++ página 87).

4. *Recibe el OnDelete evento, junto con el valor del índice dedo (VB página 47 y página 44; C ++página 92
y página 92).

5. * Eliminar la plantilla de huella digital correspondiente en el subsistema de almacenamiento de datos de


huellas dactilares.

6. * Guarde el nuevo valor de la EnrolledFingersMask en el subsistema de almacenamiento de datos de huellas


dactilares.

7. * Establecer el valor apropiado para el objeto DPFPEventHandlerStatus (VB página 71, C ++ página 126).

La 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 laFigura 5 y es seguido por explicaciones del One Touch para Windows: /
ActiveX funciones API Edición COM utilizados para realizar las tareas del flujo de trabajo.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 28
desarrollador
Capítulo 4: Visión La verificación de
general huellas dactilares

Captura de la muestra de la
huella digital
Implementar controlador
Crear un objeto DPFPCapture de eventos para Establecer las propiedades
notificaciones de eventos DPFPCapture
DPFPCaptureEvent Prioridad, ReaderSeriaTNumber

Iniciar la captura de muestras Recibe OnCompTete


de huellas digitales de lector de Captura de la huella dactilar evento con objeto
huellas digitales StartCapture de la muestra DPFPSampTe
método

Detener la captura de
muestras de huellas
digitales StopCapture
método

Extracción de características
de huellas dactilares
Crear un objeto Crear DPFPFeatureSet objeto
DPFPFeatureExtraction utilizando DataPurposeVeri {icación
CreateFeatureSet método

Recibir
DPFPFeatureSet objeto

La verificación de
huellas dactilares
Crear Establecer DPFPVeri
DPFPVeri {icación {propiedad icación
objeto FARRequested

Realizar la función del sistema de


verificación de huellas dactilares y Recibir
volver DPFPVeri {objeto DPFPVeri {icationResuTt
icationResuTt Veri {y método objeto

recuperar deserializado
DPFPTempTate objeto

Leyenda
U One Touch para Windows SDK: COM /
N
ActiveX Paso opcional

Aplicación (no es parte de


SDK) lector de huellas

dactilares

Figura 5. flujo de trabajo de verificación de huellas dactilares Típica

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 29
desarrollador
Capítulo 4: Visión La verificación de
general huellas dactilares

Captura de la muestra de la huella digital


1. * Crear una instancia de una DPFPCapture objeto (VB página 36, C ++ página 78).

2. * Implementar un controlador de eventos para DPFPCaptureEvents notificaciones de eventos (VB página


38, C ++
página 81).

3. Opcionalmente, establecer el Prioridad y ReaderSerialNumber propiedades (VB página 36 y página


37; C ++
página 78 y página 79).

4. Iniciar la captura de muestras de huellas digitales del lector de huellas digitales llamando al StartCapture
método (VB página 36, C ++ página 79).

5. ** capturar una muestra de la huella digital de un lector de huellas digitales.

6. *Recibe el OnComplete evento con un objeto DPFPSample cuando la muestra de huella


digital es capturado con éxito por el lector de huellas digitales (VB página 38, C ++ página
81).

7. * Pase el objeto DPFPSample al método CreateFeatureSet. (Véase el paso 2 en la siguiente sección).

8. Detener la captura de muestras de huellas digitales llamando al StopCapture método (VB página 36, C ++
página 80).

Extracción de características de huellas dactilares


1. * Crear una instancia de un objeto DPFPFeatureExtraction (VB página 51, C ++ página 97).

2. Crear un DPFPFeatureSet objeto llamando al CreateFeatureSet método que utiliza la


DataPurposeVerification valor y pasando un objeto DPFPSample desde el paso 7 en la
sección anterior (VB página 52, C ++ página 97).

3. * Pase el objeto DPFPFeatureSet creado en el paso anterior con el método de verificación. (Ver
paso 5 en la siguiente sección).

La verificación de huellas dactilares


1. * Crear una instancia de una DPFPVerification objeto (VB página 63, C ++ página 115).

2. Opcionalmente, establecer el FARRequested propiedad (VB página 63, C ++ página 115).


Puede utilizar esta propiedad para comprobar o modificar el valor actual de las FAR.

3. Recuperar los datos de la plantilla de huella digital en serie desde el subsistema de almacenamiento de
datos de huellas dactilares.

4. Crear un DPFPTemplate objeto a partir de los datos serializados (ver Deserializar una huella
digital de datos serializados Objeto en la página 33).

5. Realizar la función del sistema de verificación de huellas dactilares mediante una llamada al
Verificar método y pasar el objeto DPFPTemplate creado en el paso anterior y el objeto
DPFPFeatureSet desde el paso 3 en la sección anterior (VB página 63, C ++ página 116).
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 30
desarrollador
Capítulo 4: Visión La verificación de huellas digitales
general con soporte de interfaz de usuario

6. *Recibe el DPFPVerificationResult objeto, que proporciona la decisión comparación de


partido o no partido (VB página 67, C ++ página 121).

La verificación de huellas digitales 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 el
apoyo de interfaz de usuario. El flujo de trabajo se ilustra en laFigura 6 y es seguido por explicaciones
del One Touch para Windows: / ActiveX funciones API Edición COM utilizados para realizar las tareas
del flujo de trabajo.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 31
desarrollador
Capítulo 4: Visión La verificación de huellas digitales
general con soporte de interfaz de usuario

Control de verificación de
huellas dactilares
Implementar controlador de eventos
Crear DPFPVeri {icationControT para DPFPVeri {icationControTEvents
objeto notificaciones de eventos

Establecer
DPFPEnroTTmentControT Captura de la huella dactilar
propiedad de la muestra
ReaderSeriaTNumber

Recibe caso
OnCompTete con objeto
DPFPFeatureSet

La verificación de
huellas dactilares
Crear Establecer DPFPVeri
DPFPVeri {icación objeto {propiedad icación
FARRequested

Realizar la función del Recibir


sistema de verificación DPFPVeri {icationResuTt
de huellas dactilares y objeto
el retorno
DPFPVeri {icationResuTt
objeto Establecer valor apropiado
para el objeto
DPFPEventHandTerStatus

recuperar deserializado
DPFPTempTate objetos

Leyenda
U One Touch para Windows SDK: COM /
N
ActiveX Paso opcional

Aplicación (no es parte de SDK) lector


de huellas dactilares

La Figura 6. verificación de huellas dactilares típico con el flujo de trabajo de soporte UI

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 32
desarrollador
Capítulo 4: Visión La verificación de huellas digitales
general con soporte de interfaz de usuario

Control de verificación de huellas dactilares


1. * Crear una instancia de un objeto DPFPVerificationControl (VB página 64, C ++ página 118).

2. Implementar un controlador de eventos para DPFPVerificationControlEvents notificaciones de


eventos (VB
página 65, C ++ página 120).

3. Opcionalmente, establecer el ReaderSerialNumber propiedad (VB página 65, C ++ página 119).

4. ** capturar una muestra de la huella digital de un lector de huellas digitales.

5. Recibe el OnComplete evento con el objeto DPFPFeatureSet (VB página 65, C ++ página 120).

La verificación de huellas dactilares


1. * Crear una instancia de una DPFPVerification objeto (VB página 63, C ++ página 115).

2. Opcionalmente, establecer el FARRequested propiedad (VB página 63, C ++ página 115).


Puede utilizar esta propiedad para comprobar o modificar el valor actual de las FAR.

3. Recuperar los datos de la plantilla de huella digital en serie desde el subsistema de almacenamiento de
datos de huellas dactilares.

4. Crear un DPFPTemplate objeto a partir de los datos serializados (ver Deserializar una huella
digital de datos serializados Objeto en la página 33).

5. Realizar la función del sistema de verificación de huellas dactilares mediante una llamada al Verificar
método y pasando la
DPFPTemplate y objetos DPFPFeatureSet (VB página 63, C ++ página 116).

6. *Recibe el DPFPVerificationResult objeto, que proporciona la decisión comparación de


partido o no partido (VB página 67, C ++ página 121).

7. * Establecer el valor apropiado para el objeto DPFPEventHandlerStatus (VB página 71, C ++ página 126).

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 33
desarrollador
Capítulo 4: Visión Huella digital serialización de objetos de datos /
general Deserialización

Huella digital serialización de objetos de datos / Deserialización


Esta sección contiene dos flujos de trabajo: uno para serializar un objeto de datos de huellas
digitales y una para deserializar un objeto de datos de huellas digitales en serie. Los flujos de trabajo
se ilustran enFigura 7 y Figura 8 y son seguidos por explicaciones del One Touch para Windows: /
ActiveX funciones API Edición COM utilizados para realizar las tareas en los flujos de trabajo.

La serialización de un objeto de datos de huellas dactilares

s
e

Serializa objeto DPFPTempTate

serializar DPFPTempTate datos serializados


DPFPTempTate objeto objeto almacenar en el
SeriaTize método subsistema de
almacenamiento de

Leyenda
One Touch para Windows SDK: Aplicación

COM / ActiveX (no forma parte de SDK)

La Figura 7. Huella digital objeto de datos de serialización flujo de trabajo: objeto DPFPTemplate

1. * Comience con un objeto DPFPTemplate. (Véase los diversos métodos y propiedades


para crear y devolver un objeto DPFPTemplate.)

2. Serializar el objeto de datos llamando al Publicar por fascículos método (VB página 40, C ++ página
84).

3. * Almacenar los datos serializados en un subsistema de almacenamiento de datos de huellas dactilares.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 34
desarrollador
Capítulo 4: Visión Huella digital serialización de objetos de datos /
general Deserialización

Deserializar un objeto serializado de datos de huellas dactilares

U
N

objeto de datos
Deserialize
Recuperar datos de la
plantilla de huella digital Deserialize DPFPTempTate
Volver DPFPTempTate
objeto
en serie de subsistema objeto
DeseriaTize método
de almacenamiento de
datos de huellas

Leyenda
One Touch para Windows SDK: Aplicación

COM / ActiveX (no forma parte de SDK)

Figura 8. Deserialización de flujo de trabajo objeto de datos de huellas digitales en serie: objeto
DPFPTemplate

1. * Recuperar datos de la plantilla de huella digital en serie de un subsistema de almacenamiento de datos de


huellas dactilares.

2. Deserializar un objeto mediante una llamada al DPFPTemplate Deserializar método (VB página 40, C ++
página 83).

3. Devolver un objeto DPFPTemplate.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 35
desarrollador
Referencia API para Visual Basic Desarrolladores 5

En este capítulo se definen los componentes de la API para desarrollar aplicaciones que incorporan la
funcionalidad del One Touch para Windows: COM / ActiveX Edición API en Visual Basic utilizando la
aplicación Component Object Model (COM).

Objetos de componentes
IMPORTANTE: Todas las propiedades de lectura / escritura de la de un toque de objetos
componentes de la API de Windows SDK son opcionales. Si no configura una de estas
propiedades, el valor por defecto se utiliza de forma automática. Al decidir si se debe
establecer una propiedad, tenga en cuenta que DigitalPersona puede cambiar los
valores por defecto en cualquier momento sin previo aviso. Si desea que la funcionalidad
de la aplicación para mantener la coherencia, debe establecer las propiedades en
consecuencia.

El One Touch para Windows: COM / aplicación COM ActiveX Edición API incluye los objetos que lo
componen se define en esta sección. Utilice la siguiente lista para localizar rápidamente un objeto por
nombre, número de página, o por descripción.

Método Pági Descripción


na
DPFPCapture 36 Captura una muestra de la huella digital de un lector de huellas
digitales
DPFPData 40 Representa los datos que son comunes a todos los objetos de
datos de huellas dactilares
DPFPEnrollment 41 Realiza la función del sistema de registro de huellas dactilares

DPFPEnrollmentControl 43 Contiene un control ActiveX para realizar operaciones de


registro de huellas dactilares, y proporciona una interfaz de
usuario
DPFPEventHandlerStatus 51 Devuelve los códigos que indican el estado de una operación

DPFPFeatureExtraction 51 Realiza la función del sistema de extracción de características de


huellas digitales
DPFPFeatureSet 53 Representa un conjunto de características de huellas digitales

DPFPReaderDescription 54 Proporciona información sobre un lector de huellas digitales en


particular
DPFPReadersCollection 58 Proporciona información acerca de todos los lectores de huellas
digitales conectados a un sistema de

DPFPSample 60 Representa una muestra de huella digital

DPFPSampleConversion 61 Devuelve una muestra de la huella digital como una imagen

DPFPTemplate 62 Representa una plantilla de huella dactilar

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 34
desarrollador
DPFPVerification 63 Realiza la función del sistema de verificación de huellas dactilares

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 35
desarrollador
Capítulo 5: Referencia API para desarrolladores de Objetos de
Visual Basic componentes

Método Pági Descripción


na
DPFPVerificationControl 64 Contiene un control ActiveX para crear y devolver un conjunto de
características de huellas digitales creado con el propósito de
verificación, y proporciona una interfaz de usuario

DPFPVerificationResult 67 Representa los resultados de una operación de verificación de


huellas dactilares

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 36
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPCapture
Visual Basic

DPFPCapture
El objeto DPFPCapture captura una muestra de la huella digital de un lector de huellas digitales.

métodos

Método StartCapture
Empieza la captura de una muestra de la huella digital de un lector de huellas digitales. Una llamada a
este método es asincrónica y devuelve inmediatamente. La aplicación continúa para recibir eventos
hasta que el método StopCapture se llama o cuando el objeto DPFPCapture se destruye.

Sintaxis
object.StartCapture ()

posibles errores

Código de error Mensaje Descripción

-2147024809 Uno o más argumentos Una operación de captura con la prioridad


no son válidos. especificada ya existe. Ver
DPFPCapturePriorityEnum enpágina 70 para más
información.
-2147024891 El acceso general La aplicación no tiene privilegios suficientes para
denegado error. iniciar las operaciones de captura con la prioridad
especificada. Ver DPFPCapturePriorityEnum
enpágina 70 para más información.

Método StopCapture
Detiene la operación de captura de huellas dactilares de la muestra comenzó con una llamada al
método StartCapture. Este método es opcional.

Sintaxis
object.StopCapture ()

propiedades

prioridad de la propiedad
Obtiene o establece un valor que especifica la prioridad de una operación de captura de la huella dactilar de la
muestra.

Sintaxis
DPFPCapture.Priority [= enumValue]
[enumValue =] DPFPCapture.Priority

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 37
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPCapture
Visual Basic

Valores posibles

enumValue enum que especifica o recibe uno de los DPFPCapturePriorityEnum


valores de la enumeración (página 70)

Esta propiedad opcional es de lectura / escritura. Si no se establece que, se utiliza el valor


CapturePriorityNormal.

posibles errores

Código de error Mensaje Descripción

-2147352566 Fuera de rango actual. Los datos apuntado por el parámetro de


salida está fuera del rango de valores
posibles.

ReaderSerialNumber propiedad
Obtiene o establece el número de serie de un lector de huellas dactilares que captura una muestra de la huella
digital.

Sintaxis
DPFPCapture.ReaderSerialNumber [= bstrValue]
[bstrValue =] DPFPCapture.ReaderSerialNumber

Valores posibles

strValue Cuerda que especifica o recibe un número de serie lector de huellas digitales

Esta propiedad opcional es de lectura / escritura. Si no se establece que, se utiliza el siguiente valor:
{} 00000000-0000-0000-0000-000000000000. Esto significa que la aplicación recibirá
eventos desde cualquiera de los lectores de huellas digitales conectados al sistema.

posibles errores

Código de error Mensaje Descripción

-2147024809 Uno o más argumentos El formato de la cadena que contiene el lector de


no son válidos. huellas número de serie es incorrecto. Debe estar
en formato GUID, por ejemplo, {A9EFB3F6-
A8C8-4684-841E- 4330973057C6}.

Información de objeto

Tipo biblioteca DigitalPersona One Touch para componentes de dispositivo


de Windows 1.0 LibraryDPFPDevX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 38
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPCapture
Visual Basic

Eventos

OnComplete Evento
Se activa cuando una muestra de la huella digital es capturado con éxito por un lector de huellas digitales.

Sintaxis
Private Sub object_OnComplete
(ByVal bstrReaderSerNum como
secuencia,
ByVal como objeto oFingerprintSample)

parámetros

bstrReaderSerNum Cuerda que especifica un número de serie lector de huellas digitales

oFingerprintSample Un objeto DPFPSample (página 60)

OnFingerGone Evento
Se activa cuando un usuario elimina un dedo de un lector de huellas digitales.

Sintaxis
Private Sub object_OnFingerGone
(ByVal bstrReaderSerNum como
secuencia)

Parámetro

bstrReaderSerNum Cuerda que especifica un número de serie lector de huellas digitales

OnFingerTouch Evento
Se activa cuando un usuario toca un lector de huellas digitales.

Sintaxis
Private Sub OnFingerTouch (
ByVal bstrReaderSerNum como secuencia)

Parámetro

bstrReaderSerNum Cuerda que especifica un número de serie lector de huellas digitales

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 39
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPCapture
Visual Basic

OnReaderConnect Evento
Se activa cuando un lector de huellas digitales está unido a un sistema.

Sintaxis
Private Sub object_OnReaderConnect
(ByVal bstrReaderSerNum como
secuencia)

Parámetro

bstrReaderSerNum Cuerda que especifica un número de serie lector de huellas digitales

OnReaderDisconnect Evento
Se activa cuando un lector de huellas dactilares se desconecta de un sistema.

Sintaxis
Private Sub object_OnReaderDisconnect
(ByVal bstrReaderSerNum como
secuencia)

Parámetro

bstrReaderSerNum Cuerda que especifica un número de serie lector de huellas digitales

OnSampleQuality Evento
Se activa cuando se verifica la calidad de una muestra de la huella digital. Cuando SampleQualityGood se
devuelve en el
SampleQuality parámetro, el evento OnComplete se dispara (página 38).

Sintaxis
Private Sub object_OnSampleQuality
(ByVal bstrReaderSerNum como
secuencia, enumSampleQuality
ByVal como Enum)

parámetros

bstrReaderSerNum Cuerda que especifica un número de serie lector de huellas digitales

enumSampleQuality enum que especifica uno de los valores, que proporciona


retroalimentación acerca de una operación de huella digital de
captura de la muestra, de la enumeración
DPFPCaptureFeedbackEnum (página 69)

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 40
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPData
Visual Basic

DPFPData
Representa los datos que son comunes a todos objetos de datos de huellas dactilares. El objeto
DPFPData también proporciona métodos para serializar y deserializar objetos de datos de huellas
digitales.

métodos

Método Deserialize
Deserializa un objeto de datos devuelto por el método Serialize.

Sintaxis
object.Deserialize (
ByRef aRawData () As Byte)

Parámetro

aRawData Matriz de bytes que especifica un objeto de datos deserializado

posibles errores

Código de error Mensaje Descripción

-2147024809 Uno o más argumentos El formato de los datos que se pasan a la Deserialize
no son válidos. método es incorrecta.

Método serializar
Serializa un objeto de datos y lo devuelve como una matriz de bytes.

Sintaxis
Dim aRawData Como Byte ()
aRawData = object.Serialize

Parámetro

aRawData Matriz de bytes que recibe un objeto de datos serializada

Información de objeto

Tipo biblioteca DigitalPersona One Touch para los componentes compartidos


de Windows 1.0 LibraryDPFPShrX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 41
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPEnrollment
Visual Basic

Ver también
DPFPFeatureSet en la página 53
DPFPSample en la página 60
DPFPTemplate en la página 62

DPFPEnrollment
El objeto DPFPEnrollment realiza la función del sistema de registro de huellas dactilares. Este objeto
crea una plantilla de huella digital de un determinado número de conjuntos de características de
huellas digitales creados con el propósito de inscripción.

métodos

Método addFeatures
Añade conjuntos de características de huellas digitales, uno por uno, a una plantilla de huella dactilar.
La plantilla de huellas dactilares se completa cuando la propiedad TemplateStatus se establece en el
valor TemplateStatusReady.

Sintaxis
object.AddFeatures (
oFeatures ByVal como objeto)

Parámetro

oFeatures Un objeto DPFPFeatureSet (página 53)

Método clara
Borra una plantilla de huella digital y define el valor de la propiedad a TemplateStatus
TemplateStatusUnknown por lo que una aplicación puede iniciar otra operación de creación de plantillas de
huellas digitales.

Sintaxis
object.Clear ()

propiedades

FeaturesNeeded propiedad
Obtiene el número de conjuntos de características de huellas dactilares todavía se necesitan para crear una
plantilla de huellas dactilares. Cuando el valor de
lValue es igual a 0, se crea la plantilla de huellas dactilares.

Sintaxis
[LValue =] DPFPEnrollment.FeaturesNeeded
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 42
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPEnrollment
Visual Basic

Valores posibles

lValue Largo que recibe el valor del número de conjuntos de características de huellas digitales

Esta propiedad se de sólo lectura y no tiene valor predeterminado.

propiedad plantilla
Obtiene un objeto DPFPTemplate creado durante una operación de registro de huellas dactilares.

Sintaxis
[OTemplate =] DPFPEnrollment.Template

Valores posibles

oTemplate Un objeto DPFPTemplate (página 62)

Esta propiedad se de sólo lectura y no tiene valor predeterminado.

posibles errores

Código de error Mensaje Descripción

-2147352573 Miembro no Una plantilla de huella digital no se ha creado todavía.


encontrado.

TemplateStatus propiedad
Obtiene un valor que especifica el estado de una operación de creación de plantillas de huellas digitales.

Sintaxis
[EnumValue =] DPFPEnrollment.TemplateStatus

Valores posibles

enumValue enum que recibe uno de los valores DPFPTemplateStatusEnum de


enumeración (página 75)

Esta propiedad se de sólo lectura y no tiene valor predeterminado.

Información de objeto

Tipo biblioteca DigitalPersona One Touch para componentes de motor de

Windows 1.0 LibraryDPFPEngX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 43
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPEnrollmentControl
Visual Basic

DPFPEnrollmentControl
El objeto DPFPEnrollmentControl contiene un control ActiveX que implementa una interfaz de
usuario (descrito en DPFPEnrollmentControl objeto de interfaz de usuario en la página 131) Y
proporciona la siguiente funcionalidad:
 Captura muestras de huellas digitales de un lector de huellas digitales (s)
 Crea conjuntos de características de huellas digitales para el propósito de la inscripción
 Crea plantillas de huellas dactilares
 Notifica a una aplicación cuando el afiliado se compromete a eliminar una plantilla de huella digital
 eventos incendios

propiedades

EnrolledFingersMask propiedad
Obtiene o establece la máscara que representa huellas digitales registradas del usuario. La máscara de la
inscripción es una combinación de lavalores que representan las huellas digitales incluidas de un
usuario. Por ejemplo, si el derecho huella del dedo índice de un usuario y la huella digital media
derecha están inscritos, el valor de esta propiedad es 00000000 011 000 000, o 192.

Sintaxis
DPFPEnrollmentControl.EnrolledFingersMask [= lValue]
[lValue =] DPFPEnrollmentControl.EnrolledFingersMask

Valores posibles

lValue Largo que especifica o recibe el valor de la máscara de huellas


dactilares. Todos los valores posibles se enumeran en la Tabla 4.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 44
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPEnrollmentControl
Visual Basic

Tabla 4. Los valores para la máscara de la matrícula

Dedo La representación binaria Representación de


enteros
meñique izquierda 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 dieci


séis
Pulgar derecho 000000000 000100000 32

dedo índice derecho 000000000 001000000 64

dedo medio derecho 000000000 010000000 128

dedo anular derecho 000000000 100000000 256

meñique derecho 000000001 000000000 512

Esta propiedad opcional es de lectura / escritura. Si no se establece que, el valor 0 se utiliza, lo


que significa que no hay huellas digitales se han inscrito.

posibles errores

Código de error Mensaje Descripción

-2147352566 Fuera de rango actual. Los datos apuntado por el parámetro de


salida está fuera del rango de valores
posibles.

MaxEnrollFingerCount propiedad
Obtiene o establece el valor para el número máximo de huellas digitales que pueden ser inscrito.

Sintaxis
DPFPEnrollmentControl.MaxEnrollFingerCount [= lValue]
[lValue =] DPFPEnrollmentControl.MaxEnrollFingerCount

Valores posibles

lValue Largo que especifica o recibe el valor para el número máximo de huellas
dactilares que puede ser inscrito. Los valores posibles son 1 a 10.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 45
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPEnrollmentControl
Visual Basic

Esta propiedad opcional es de lectura / escritura. Si no se establece que, se utiliza el valor 10, lo
que significa que el usuario puede inscribir a todos los diez huellas dactilares.

posibles errores

Código de error Mensaje Descripción

-2147352566 Fuera de rango actual. Los datos apuntado por el parámetro de


salida está fuera del rango de valores
posibles.

ReaderSerialNumber propiedad
Obtiene o establece el número de serie del lector de huellas digitales desde el que se capturó una muestra de la
huella digital.

Sintaxis
DPFPEnrollmentControl.ReaderSerialNumber [= bstrValue]
[bstrValue =] DPFPEnrollmentControl.ReaderSerialNumber

Valores posibles

bstrValue Cuerda que especifica o recibe el número de serie lector de huellas digitales

Esta propiedad opcional es de lectura / escritura. Si no se establece que, se utiliza el siguiente valor:
{} 00000000-0000-0000-0000-000000000000. Esto significa que la aplicación recibirá
eventos desde cualquiera de los lectores de huellas digitales conectados al sistema.

posibles errores

Código de error Mensaje Descripción

-2147024809 Uno o más argumentos El formato de la cadena que contiene el lector de


no son válidos. huellas número de serie es incorrecto. Debe estar
en formato GUID, por ejemplo, {A9EFB3F6-
A8C8-4684-841E- 4330973057C6}.

Información de objeto

Tipo biblioteca DigitalPersona One Touch para el control de

Windows 1.0 LibraryDPFPCtlX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 46
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPEnrollmentControl
Visual Basic

Eventos

OnCancelEnroll Evento
Se activa cuando la inscripción se cancela.

Sintaxis
Private Sub object_OnCanceEnroll
(ByVal pSerialNumber como
secuencia, de ByVal
lEnrolledFinger como de
largo)

parámetros

pSerialNumber [En] Variable de tipo String que contiene un número de serie lector de huellas
digitales.
lEnrolledFinger [En] valor de índice dedo incluido, en la norma ANSI / NIST-ITL 1. Para valores posibles,
ver
Tabla 5.

losparámetro l1FingerMask es el valor de índice del dedo asociado con una huella digital para ser
inscrito o una plantilla de huella dactilar se va a eliminar, tal como se definen en la norma ANSI /
NIST-ITL 1. Los valores de índice se asignan a la representación gráfica de los dedos de las manos
en la interfaz de usuario. Todos los valores posibles se enumeran en la Tabla 5.

Tabla 5. los valores de índice de dedo en ANSI / NIST-ITL 1

Dedo Índice de Dedo Índice de


Valor Valor
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

meñique derecho 5 meñique izquierda 10

OnComplete Evento
Incendios en una exploración exitosa.

Sintaxis
Private Sub object_OnComplete
(ByVal pSerialNumber como
secuencia, de ByVal
lEnrolledFinger como de largo)

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 47
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPEnrollmentControl
Visual Basic

parámetros

pSerialNumber [En] Variable de tipo String que contiene un número de serie lector de huellas
digitales.
lEnrolledFinger [En] valor de índice dedo incluido, en la norma ANSI / NIST-ITL 1. Para valores posibles,
ver
Tabla 5.

OnDelete Evento
Se activa cuando un usuario se compromete a eliminar una huella digital registrada. La
aplicación se encarga de 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 de error.

Sintaxis
Private Sub object_OnDelete
(ByVal l1FingerMask As
Long, ByVal como objeto
ostatus)

parámetros

l1FingerMask Largo que especifica el valor del índice de la huella dactilar (inscrito) para ser
eliminado.
Para valores posibles, véase la Tabla 5.
ostatus Un objeto DPFPEventHandlerStatus (página 51)

OnEnroll Evento
Se activa cuando un usuario se inscribe una huella digital y devuelve una plantilla de huella dactilar. La
aplicación se ocupa del 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 de
error.

Sintaxis
Private Sub object_OnEnroll
(ByVal l1FingerMask como de
largo,
ByVal oFingerprintTemplate como
objeto, ByVal como objeto ostatus)

parámetros

l1FingerMask Largo que especifica el valor del índice de la huella digital registrada. por
valores posibles, véase la Tabla 5 en la página 46.
oFingerprintTemplate Un objeto DPFPTemplate (página 62)
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 48
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPEnrollmentControl
Visualostatus
Basic Un objeto DPFPEventHandlerStatus (página 51)

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 49
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPEnrollmentControl
Visual Basic

OnFingerRemove Evento
Se activa cuando un usuario quita su dedo de la lector de huellas digitales.

Sintaxis
Private Sub object_OnFingerRemove
(ByVal pSerialNumber como
secuencia, de ByVal
lEnrolledFinger como de largo)
parámetros

pSerialNumber [En] Variable de tipo String que contiene un número de serie lector de huellas
digitales.
lEnrolledFinger [En] valor de índice dedo incluido, en la norma ANSI / NIST-ITL 1. Para valores posibles,
ver
Tabla 5.

OnFingerTouch Evento
Se activa cuando un usuario toca un lector de huellas digitales.

Sintaxis
Private Sub object_OnFingerTouch
(ByVal pSerialNumber como
secuencia, de ByVal
lEnrolledFinger como de
largo)

parámetros

pSerialNumber [En] Variable de tipo String que contiene un número de serie lector de huellas
digitales.
lEnrolledFinger [En] valor de índice dedo incluido, en la norma ANSI / NIST-ITL 1. Para valores posibles,
ver
Tabla 5.

OnReaderConnect Evento
Se activa cuando se conecta un lector.

Sintaxis
Private Sub object_OnReaderConnect
(ByVal pSerialNumber como
secuencia, de ByVal
lEnrolledFinger como de largo)

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 50
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPEnrollmentControl
Visual Basic

parámetros

pSerialNumber [En] Variable de tipo String que contiene un número de serie lector de huellas
digitales.
lEnrolledFinger [En] valor de índice dedo incluido, en la norma ANSI / NIST-ITL 1. Para valores posibles,
ver
Tabla 5.

OnReaderDisconnect Evento
Se activa cuando se desconecta un lector.

Sintaxis
Private Sub object_OnReaderDisconnect
(ByVal pSerialNumber como
secuencia, de ByVal
lEnrolledFinger como de largo)

parámetros

pSerialNumber [En] Variable de tipo String que contiene un número de serie lector de huellas
digitales.
lEnrolledFinger [En] valor de índice dedo incluido, en la norma ANSI / NIST-ITL 1. Para valores posibles,
ver
Tabla 5.

OnSampleQuality Evento
Se activa cuando se recibe una muestra de la huella digital.

Sintaxis
Private Sub object_OnSampleQuality
(ByVal pSerialNumber como
secuencia, de ByVal
lEnrolledFinger As Long, ByVal
lSampleQuality como de largo)

parámetros

pSerialNumber [En] Variable de tipo String que contiene un número de serie lector de huellas
digitales.
lEnrolledFinger [En] valor de índice dedo incluido, en la norma ANSI / NIST-ITL 1. Para valores posibles,
ver
Tabla 5.
lSampleQuality [En] Variable que contiene un valor que proporciona
retroalimentación acerca de una operación de muestra de la huella
digital. Para posibles valores, consulte el
DPFPCaptureFeedbackEnumpágina 69.
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 51
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPEnrollmentControl
Visual Basic

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 52
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPEnrollmentControl
Visual Basic

OnStartEnroll Evento
Se activa cuando la inscripción ha comenzado.

Sintaxis
Private Sub object_OnStartEnroll
(ByVal pSerialNumber como
secuencia, de ByVal
lEnrolledFinger como de
largo)

parámetros

pSerialNumber [En] Variable de tipo String que contiene un número de serie lector de huellas
digitales.
lEnrolledFinger [En] valor de índice dedo incluido, en la norma ANSI / NIST-ITL 1. Para valores posibles,
ver
Tabla 5.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 53
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPEventHandlerStatus
Visual Basic

DPFPEventHandlerStatus
El objeto DPFPEventHandlerStatus devuelve códigos que indican el estado de una operación.

propiedades

Estado de la propiedad
Obtiene o establece el estado de una operación realizada por un objeto DPFPEnrollmentControl (página 43) O por
una
DPFPVerificationControl objeto (página 64).

Sintaxis
DPFPEventHandlerStatus.Status [= enumValue]
[enumValue =] DPFPEventHandlerStatus.Status

Valores posibles

enumValue enum que especifica o recibe uno de los valores de la


DPFPEventHandlerStatusEnum enumeración (página 71)

Esta propiedad opcional es de lectura / escritura. Si no se establece que, el valor


DPFPEventHandlerStatusSuccess
se utiliza.

posibles errores

Código de error Mensaje Descripción

-2147352566 Fuera de rango actual. Los datos apuntado por el parámetro de


salida está fuera del rango de valores
posibles.

Información de objeto

Tipo biblioteca DigitalPersona One Touch para el control de

Windows 1.0 LibraryDPFPCtlX.dll

DPFPFeatureExtraction
el DPFPFeatureExtraction realiza objetos extracción de características de huellas digitales. Este objeto
crea una característica de huellas digitales establecido para el propósito de la inscripción o la
verificación mediante la aplicación de extracción de características de huellas digitales para una
muestra de la huella digital.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 54
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPFeatureExtraction
Visual Basic

Método

Método CreateFeatureSet
Se aplica la extracción de características de huellas digitales para una muestra de la huella digital y
luego crea una característica de huellas digitales fijado para el fin indicado.

Sintaxis
Dim enumSampleQuality Como DPFPCaptureFeedbackEnum
enumSampleQuality = object.CreateFeatureSet (
ByVal oFingerprintSample como objeto,
ByVal enumPurpose Como Enum)

parámetros

oFingerprintSample Un objeto DPFPSample (página 60)


enumPurpose enum que especifica uno de los valores, que es para el fin
especificado, de la enumeración DPFPDataPurposeEnum (página
72)
enumSampleQuality enum la recibe uno de los valores, que proporciona retroalimentación acerca de
una
operación de captura de muestras de huellas dactilares, de la
DPFPCaptureFeedbackEnum enumeración (página 69)

Propiedad

FeatureSet propiedad
Recupera un objeto DPFPFeatureSet creado durante una operación de extracción de características de huellas
digitales.

Sintaxis
[OFeatureSet =] DPFPFeatureExtraction.FeatureSet

Valores posibles

oFeatureSet Un objeto DPFPFeatureSet (página 53)

Esta propiedad se de sólo lectura y no tiene valor predeterminado.


posibles errores

Código de error Mensaje Descripción

-2147352573 Miembro no Un conjunto de características de huellas digitales no


encontrado. se ha creado todavía.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 55
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPFeatureSet
Visual Basic

Información de objeto

Tipo biblioteca DigitalPersona One Touch para componentes de motor de


Windows 1.0 LibraryDPFPEngX.dll

DPFPFeatureSet
El objeto DPFPFeatureSet representa un conjunto de características de huellas digitales.

métodos

Método Deserialize
Deserializa un objeto de datos devuelto por el método Serialize.

Sintaxis
object.Deserialize (
ByRef aRawData () As Byte)

Parámetro

aRawData Matriz de bytes que especifica un objeto de datos deserializado

posibles errores

Código de error Mensaje Descripción

-2147024809 Uno o más argumentos El formato de los datos que se pasan a la Deserialize
no son válidos. método es incorrecta.

Método serializar
Serializa un objeto de datos y lo devuelve como una matriz de bytes.

Sintaxis
Dim aRawData Como Byte ()
aRawData = object.Serialize

Parámetro

aRawData Matriz de bytes que recibe un objeto de datos serializada

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 56
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPReaderDescription
Visual Basic

Información de objeto

Tipo libraryDigitalPersona One Touch para los componentes compartidos de Windows 1.0
LibraryDPFPShrX.dll

DPFPReaderDescription
El objeto DPFPReaderDescription proporciona información sobre un lector de huellas digitales en
particular, como su tecnología o número de serie.

propiedades

FirmwareRevision propiedad
Obtiene el número de revisión del firmware de un lector de huellas digitales.

Sintaxis
[BstrValue =] DPFPReaderDescription.FirmwareRevision

Valores posibles

bstrValue Cuerda la recibe el número de revisión de firmware lector de huellas digitales

Esta propiedad se de sólo lectura y no tiene valor predeterminado.

HardwareRevision propiedad
Obtiene el número de revisión del hardware de un lector de huellas digitales.

Sintaxis
[BstrValue =] DPFPReaderDescription.HardwareRevision

Valores posibles

bstrValue Cuerda la recibe el número de revisión de hardware lector de huellas digitales

Esta propiedad se de sólo lectura y no tiene valor predeterminado.

idioma propiedad
Obtiene el idioma lector de huellas digitales.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 57
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPReaderDescription
Visual Basic

Sintaxis
[BstrValue =] DPFPReaderDescription.get_Language

Valores posibles

bstrValue Cuerda la recibe el idioma lector de huellas digitales. El valor de bstrValue


es siempre 0x409, que es Inglés.

Esta propiedad se de sólo lectura y no tiene valor predeterminado.

ImpressionType propiedad
Obtiene un valor que especifica el tipo de impresión lector de huellas digitales, por ejemplo, lector swipe o
táctil (área) lector.

Sintaxis
[EnumValue =] DPFPReaderDescription.ImpressionType

Valores posibles

enumValue enum que recibe uno de los valores de la


DPFPReaderImpressionTypeEnum enumeración (página 73)

Esta propiedad se de sólo lectura y no tiene valor predeterminado.

ProductName propiedad
Obtiene el nombre de producto de un lector de huellas digitales, por ejemplo, “U.are.U.”

Sintaxis
[BstrValue =] DPFPReaderDescription.ProductName

Valores posibles

bstrValue Cuerda que recibe el nombre de producto lector de huellas digitales

Esta propiedad se de sólo lectura y no tiene valor predeterminado.

SerialNumber propiedad
Obtiene el número de serie de un lector de huellas digitales. Esta propiedad se de sólo lectura y no tiene valor
predeterminado.

Sintaxis
[BstrValue =] DPFPReaderDescription.SerialNumber

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 58
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPReaderDescription
Visual Basic

Valores posibles

bstrValue Cuerda la recibe el número de serie lector de huellas digitales

Esta propiedad se de sólo lectura y no tiene valor predeterminado.

SerialNumberType propiedad
Obtiene un valor que especifica el tipo de número de serie lector de huellas digitales.

Sintaxis
[EnumValue =] DPFPReaderDescription.SerialNumberType

Valores posibles

enumValue enum que recibe uno de los valores de la DPFPSerialNumberTypeEnum


enumeración (página 74)
Esta propiedad se de sólo lectura y no tiene valor predeterminado.

tecnología de la propiedad
Obtiene un valor que especifica la tecnología lector de huellas digitales.

Sintaxis
[EnumValue =] DPFPReaderDescription.Technology

Valores posibles

enumValue enum que recibe uno de los valores de la DPFPReaderTechnologyEnum


enumeración (página 73)

Esta propiedad se de sólo lectura y no tiene valor predeterminado.

propiedad proveedor
Obtiene el nombre del proveedor para un lector de huellas digitales, por ejemplo, “DigitalPersona, Inc.”

Sintaxis
[BstrValue =] DPFPReaderDescription.Vendor

Valores posibles

bstrValue Cuerda la recibe el nombre del proveedor lector de huellas digitales

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 59
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPReaderDescription
Visual Basic

Esta propiedad se de sólo lectura y no tiene valor predeterminado.

Información de objeto

Tipo biblioteca DigitalPersona One Touch para componentes de dispositivo

de Windows 1.0 LibraryDPFPDevX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 60
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPReadersCollection
Visual Basic

DPFPReadersCollection
El objeto DPFPReadersCollection proporciona información acerca de todos los lectores de huellas
digitales conectados a un sistema.

Método

Método lector
Devuelve un objeto DPFPReaderDescription para un lector de huellas digitales particular usando su número de
serie.

Sintaxis
Dim oReader Como
DPFPReaderDescription Conjunto
oReader = object.Reader (
ByVal bstrReaderSerialNum como secuencia)

parámetros

bstrReaderSerialNumber Cuerda que especifica un número de serie lector de huellas digitales

oReader Un objeto DPFPReaderDescription (página 54)

posibles errores

Código de error Mensaje Descripción

-2147024894 El sistema no puede El lector de huellas dactilares con el


encontrar el archivo número de serie especificado no se puede
especificado. encontrar en el sistema.

propiedades

contar la propiedad
Obtiene el número total de objetos DPFPReaderDescription (artículos) conectadas a un sistema (una colección).

Sintaxis
[LCount =] DPFPReadersCollection.Count

Valores posibles

lCount Largo que recibe el número total de objetos DPFPReaderDescription

Esta propiedad se de sólo lectura y no tiene valor predeterminado.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 61
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPReadersCollection
Visual Basic

propiedad de artículos
Obtiene o establece un objeto DPFPReaderDescription (un elemento) a partir de los lectores de
huellas digitales conectados a un sistema (una colección) usando su índice.

Sintaxis
[LReader =] DPFPReadersCollection.Item

Valores posibles

lReader Largo que especifica el índice del objeto DPFPReaderDescription


recuperar de la colección. El valor de lReader comienza con 1.

Esta propiedad se de sólo lectura y no tiene valor predeterminado.

posibles errores

Código de error Mensaje Descripción


-2147352565 índice no válido. El índice especificado no está en el rango válido de 1 a
Count.

_NewEnum propiedad
Obtiene un objeto ReaderEnum (objeto enumeración), que es una matriz de DPFPReaderDescription
objetos.

Sintaxis
[AReaderEnum =] DPFPReadersCollection._NewEnum

Valores posibles

aReaderEnum IUnknown que recibe el conjunto de objetos DPFPReaderDescription

Esta propiedad se de sólo lectura y no tiene valor predeterminado.

Información de objeto

Tipo biblioteca DigitalPersona One Touch para componentes de dispositivo


de Windows 1.0 LibraryDPFPDevX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 62
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPSample
Visual Basic

DPFPSample
El objeto DPFPSample representa una muestra de huella digital capturada de un lector de huellas digitales.

métodos

Método Deserialize
Deserializa un objeto de datos devuelto por el método Serialize.

Sintaxis
object.Deserialize (
ByRef aRawData () As Byte)

Parámetro

aRawData Matriz de bytes que especifica un objeto de datos deserializado

posibles errores

Código de error Mensaje Descripción

-2147024809 Uno o más argumentos El formato de los datos que se pasan a la Deserialize
no son válidos. método es incorrecta.

Método serializar
Serializa un objeto de datos y lo devuelve como una matriz de bytes.

Sintaxis
Dim aRawData Como Byte ()
aRawData = object.Serialize

Parámetro

aRawData Matriz de bytes que recibe un objeto de datos serializada

Información de objeto

Tipo biblioteca DigitalPersona One Touch para los componentes compartidos


de Windows 1.0 LibraryDPFPShrX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 63
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPSampleConversion
Visual Basic

Ver también
DPFPData en la página 40

DPFPSampleConversion
El objeto SampleConversion proporciona métodos para el retorno de una muestra de huella digital como un
IPicture
objetar y como una imagen en formato ANSI 381.

métodos

Método ConvertToANSI381
Convierte una muestra de huellas digitales para una imagen en formato ANSI 381.

Dim aAnsi Como Byte ()


aAnsi = object.ConvertToANSI381
(ByVal oSample Como Object)

parámetros

oSample Un objeto DPFPSample (página 60)

vAnsi Variante que recibe una imagen en formato ANSI 381

Método ConvertToPicture
Convierte una muestra de huellas digitales a un objeto IPicture.

Sintaxis
Dim oPicture Como IPictureDisp
Establecer oPicture =
object.ConvertToPicture (ByVal como
objeto oSample)

parámetros

oSample Un objeto DPFPSample (página 60)

oPicture Un objeto IPicture

Información de objeto

Tipo biblioteca DigitalPersona One Touch para componentes de dispositivo

de Windows 1.0 LibraryDPFPDevX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 64
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPTemplate
Visual Basic

DPFPTemplate
El objeto DPFPTemplate representa una plantilla de huella dactilar.

métodos

Método Deserialize
Deserializa un objeto de datos devuelto por el método Serialize.

Sintaxis
object.Deserialize (
ByRef aRawData () As Byte)

Parámetro

aRawData Matriz de bytes que especifica un objeto de datos deserializado

posibles errores

Código de error Mensaje Descripción

-2147024809 Uno o más argumentos El formato de los datos que se pasan a la Deserialize
no son válidos. método es incorrecta.

Método serializar
Serializa un objeto de datos y lo devuelve como una matriz de bytes.

Sintaxis
Dim aRawData Como Byte ()
aRawData = object.Serialize

Parámetro

aRawData Matriz de bytes que recibe un objeto de datos serializada

Información de objeto

Tipo biblioteca DigitalPersona One Touch para los componentes compartidos


de Windows 1.0 LibraryDPFPShrX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 65
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPVerification
Visual Basic

DPFPVerification
El objeto DPFPVerification realiza la función del sistema de verificación de huellas dactilares, Que es una
de uno a uno comparación de una característica de huellas dactilares de conjunto con una plantilla de
huella digital producida en la inscripción que devuelve una decisión de partido o no partido.

Método

verificar el método
Realiza la función del sistema de verificación de huellas dactilares y especifica una decisión
basada en la comparación de lo solicitado FAR establecido por la propiedad FARRequested.

Sintaxis
Dim oVerificationResult Como DPFPVerificationResult
Conjunto oVerificationResult = object.Verify (
ByVal oVerificationFeatureSet como objeto,
ByVal como objeto oFingerprintTemplate)

parámetros

oFeatureSet Un objeto DPFPFeatureSet, donde el parámetro enumPurpose del


método CreateFeatureSet del objeto DPFPFeatureExtraction se
establece en el valor DataPurposeVerification (página 52)
oTemplate Un objeto DPFPTemplate (página 62)
oVerificationResult Un objeto DPFPVerificationResult (página 67)

propiedades

FARRequested propiedad
Obtiene o establece la tasa aceptar falsa solicitada (FAR). Para obtener más información acerca de las
FAR, véaseLos falsos positivos y Falso negativos en la página 19.

IMPORTANTE: Aunque el valor por defecto es adecuada para la mayoría de las aplicaciones, es
posible que necesite un valor inferior o superior para satisfacer sus necesidades. Si
decide utilizar un valor distinto del predeterminado, asegúrese de que entiende las
consecuencias de hacerlo. Referirse aApéndice A en la página 147 para obtener más
información sobre cómo establecer el valor de las FAR.

Sintaxis
DPFPVerification.FARRequested [= lValue]
[lValue =] DPFPVerification.FARRequested

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 66
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPVerificationControl
Visual Basic

Valores posibles

lValue Largo que especifica o recibe el valor de las FAR solicitado

Esta propiedad opcional es de lectura / escritura. Si no se establece que, se utiliza el valor por defecto. Se
puede utilizar el
FARRequested propiedad de acceso función para comprobar o modificar el valor actual de las FAR.

posibles errores

Código de error Mensaje Descripción

-2147352566 Fuera de rango actual. Los datos apuntado por el parámetro de


salida está fuera del rango de valores
posibles.

Información de objeto

Tipo biblioteca DigitalPersona One Touch para componentes de motor de

Windows 1.0 LibraryDPFPEngX.dll

Ver también
DPFPVerificationResult en la página 67

DPFPVerificationControl
El objeto DPFPVerificationControl es un control ActiveX que implementa una interfaz de usuario
(descrito en DPFPEnrollmentControl objeto de interfaz de usuario en la página 131) Y proporciona la
siguiente funcionalidad:
 Recibe lector de huellas digitales conectar y desconectar las notificaciones de eventos
 Captura muestras de huellas digitales de un lector de huellas digitales (s)
 Crea conjuntos de características de huellas digitales para el propósito de la verificación
 Se dispara un evento

Propiedad

propiedad activo
Activa o desactiva la captura de huellas dactilares. Por defecto es cierto.

Sintaxis
DPFPVerificationControl.Active [= bolleanVal]
[booleanVal =] DPFPVerificationControl.Active

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 67
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPVerificationControl
Visual Basic

Valores posibles

booleanVal Boole que especifica o recibe el estado de captura actual.

ReaderSerialNumber propiedad
Obtiene o establece el número de serie del lector de huellas digitales desde el que se capturó una muestra de la
huella digital.

Sintaxis
DPFPVerificationControl.ReaderSerialNumber [= bstrValue]
[bstrValue =] DPFPVerificationControl.ReaderSerialNumber

Valores posibles

bstrValue Cuerda que especifica o recibe el número de serie lector de huellas digitales

Este valor opcional es de lectura / escritura. Si no se establece que, se utiliza el siguiente valor:
{} 00000000-0000-0000-0000-000000000000. Esto significa que la aplicación recibirá
eventos desde cualquiera de los lectores de huellas digitales conectados al sistema.

posibles errores

Código de error Mensaje Descripción

-2147024809 Uno o más argumentos El formato de la cadena que contiene el lector de


no son válidos. huellas número de serie es incorrecto. Debe estar
en formato GUID, por ejemplo, {A9EFB3F6-
A8C8-4684-841E- 4330973057C6}.

Información de objeto

Tipo biblioteca DigitalPersona One Touch para el control de


Windows 1.0 LibraryDPFPCtlX.dll

Evento

OnComplete Evento
Se activa cuando un conjunto de características de huellas dactilares creado con el propósito de
verificación está listo para la comparación y devuelve el conjunto de características de huellas
dactilares. La aplicación se encarga de la comparación de la huella digital característica conjunto con
una plantilla de huellas dactilares.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 68
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPVerificationControl
Visual Basic

Sintaxis
Private Sub object_OnComplete (
ByVal oVerificationFeatureSet como objeto,
ByVal como objeto ostatus)

parámetros

oVerificationFeatureSet Un objeto DPFPFeatureSet, que representa una huella digital


conjunto de características creado con el propósito de verificación
(página 53)
ostatus Un objeto DPFPEventHandlerStatus (página 51)

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 69
desarrollador
Capítulo 5: Referencia API para desarrolladores de DPFPVerificationResult
Visual Basic

DPFPVerificationResult
El objeto DPFPVerificationResult representa los resultados de una operación de verificación de huellas dactilares.

propiedades

FARAchieved propiedad
Obtiene el valor de las FAR alcanzado por una operación de comparación.

Sintaxis
[LValue =] DPFPVerificationResult.FARAchieved

Valores posibles

lValue Largo que recibe el valor de la FAR que se logró para la comparación

Esta propiedad se de sólo lectura y no tiene valor predeterminado. VerConseguido FAR en la página
149 para más información sobre esta propiedad.

verificado la propiedad
Obtiene la decisión de comparación, que indica si la comparación de un conjunto de características
de huellas digitales y una plantilla de huella dactilar resultaron en una decisión de partido o no
partido. Esta decisión se basa en el valor de la propiedad del objeto FARRequested
DPFPVerification (página 63).

Sintaxis
[VbValue =] DPFPVerificationResult.Verified

Valores posibles

vbValue Variante de tipo booleano que recibe la decisión comparación. Valores


posiblesson verdaderas de decisión del partido o falsa de una decisión de
no coincidencia.

Esta propiedad se de sólo lectura y no tiene valor predeterminado.

Información de objeto

Tipo biblioteca DigitalPersona One Touch para componentes de motor de


Windows 1.0 LibraryDPFPEngX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 70
desarrollador
Capítulo 5: Referencia API para desarrolladores de enumeracion
Visual Basic es

enumeraciones
El One Touch para Windows: COM / ActiveX aplicación Edición COM API incluye las enumeraciones
definidas en esta sección. Utilice la siguiente lista para localizar rápidamente una enumeración por su
nombre, por número de página, o por descripción.

Método Pági Descripción


na
DPFPCaptureFeedbackEnum 69 Eventos devueltos por un lector de huellas digitales que
proporcionan información acerca de una operación de
captura de la huella dactilar de la muestra
DPFPCapturePriorityEnum 70 Prioridad de una operación de captura de la huella dactilar
de la muestra
DPFPEventHandlerStatusEnum 71 Códigos que se devuelven por el DPFPEventHandlerStatus
objeto para indicar el estado de una operación

DPFPDataPurposeEnum 72 Propósito para el cual un conjunto de características de


huellas digitales es para ser utilizado
DPFPReaderImpressionTypeEnum 73 Modalidad que utiliza un lector de huellas digitales para
capturar muestras de huellas digitales

DPFPReaderTechnologyEnum 73 tecnología de lector de huellas digitales

DPFPSerialNumberTypeEnum 74 Lector de huellas dactilares número de serie persistencia


después de reiniciar
DPFPTemplateStatusEnum 75 Estado de una operación de creación de plantillas de huellas
digitales

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 71
desarrollador
Capítulo 5: Referencia API para desarrolladores de Enumeración DPFPCaptureFeedbackEnum
Visual Basic

Enumeración DPFPCaptureFeedbackEnum
La enumeración DPFPCaptureFeedbackEnum define los eventos devueltos por un lector de huellas
dactilares que proporcionan retroalimentación sobre una operación de la huella digital de captura de
muestra.

Sintaxis
Enum DPFPCaptureFeedbackEnum
{CaptureFeedbackGood =
0,
CaptureFeedbackNone = 1,
CaptureFeedbackTooLight = 2,
CaptureFeedbackTooDark = 3,
CaptureFeedbackTooNoisy = 4,
CaptureFeedbackLowContrast = 5,
CaptureFeedbackNotEnoughFtrs = 6,
CaptureFeedbackNoCentralRgn = 7,
CaptureFeedbackNoFinger = 8,
CaptureFeedbackTooHigh = 9,
CaptureFeedbackTooLow = 10,
CaptureFeedbackTooLeft = 11,
CaptureFeedbackTooRight = 12,
CaptureFeedbackTooStrange = 13,
CaptureFeedbackTooFast = 14,
CaptureFeedbackTooSkewed = 15,
CaptureFeedbackTooShort = 16,
CaptureFeedbackTooSlow = 17,
End Enum

constantes

CaptureFeedbackGood La muestra de la huella digital es de buena calidad.


CaptureFeedbackNone No hay ninguna muestra de la huella
digital. CaptureFeedbackTooLight La muestra de la huella digital es
demasiado clara. CaptureFeedbackTooDark La muestra de la huella
digital es demasiado oscura CaptureFeedbackTooNoisy La muestra de la
huella digital es demasiado ruidoso. CaptureFeedbackLowContrast El
contraste de la muestra de huella digital es demasiado bajo.

CaptureFeedbackNotEnoughFtrs La muestra de la huella digital no contiene suficiente


información.
CaptureFeedbackNoCentralRgn La muestra de la huella digital no está centrada.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 72
desarrollador
Capítulo 5: Referencia API para desarrolladores de Enumeración DPFPCapturePriorityEnum
Visual Basic

CaptureFeedbackNoFinger El objeto escaneado no es un dedo.


CaptureFeedbackTooHigh El dedo era demasiado alta en el sensor
más fuerte. CaptureFeedbackTooLow El dedo era demasiado bajo en el sensor
más fuerte.

CaptureFeedbackTooLeft El dedo estaba demasiado cerca del borde izquierdo del golpe
sensor.
CaptureFeedbackTooRight El dedo estaba demasiado cerca del borde derecho del golpe
sensor.
CaptureFeedbackTooStrange La exploración tiene un aspecto
extraño. CaptureFeedbackTooFast El dedo se limpió con demasiada
rapidez. CaptureFeedbackTooSkewed La muestra de la huella digital es
demasiado sesgada. CaptureFeedbackTooShort La muestra de la
huella digital es demasiado corto.

CaptureFeedbackTooSlow El dedo se limpió con demasiada lentitud.

observaciones
Los miembros de esta enumeración se denominan por el método CreateFeatureSet del objeto
DPFPFeatureExtraction (página 52) Y por el evento OnSampleQuality del objeto DPFPCapture
(página 39).

Información enumeración

Tipo biblioteca DigitalPersona One Touch para los componentes compartidos


de Windows 1.0 LibraryDPFPShrX.dll

Enumeración DPFPCapturePriorityEnum
La enumeración DPFPCapturePriorityEnum define la prioridad de una operación de captura de
muestra de la huella digital realizado por un lector de huellas digitales.

Sintaxis
Enum DPFPCapturePriorityEnum
{CapturePriorityLow = 0,
CapturePriorityNormal = 1,
CapturePriorityHigh = 2,
End Enum

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 73
desarrollador
Capítulo 5: Referencia API para desarrolladores de Enumeración DPFPEventHandlerStatusEnum
Visual Basic

constantes

CapturePriorityLow Baja prioridad. Una aplicación utiliza esta prioridad para adquirir eventos de
el lector de huellas digitales sólo si no hay abonados con
prioridad alta o normal. Sólo se permite un suscriptor con
esta prioridad.
CapturePriorityNormal prioridad normal. Una aplicación utiliza esta prioridad para adquirir eventos de
el lector de huellas digitales sólo si la operación se ejecuta
en un proceso en primer plano. se permiten múltiples
suscriptores con esta prioridad.
CapturePriorityHigh Alta prioridad. (Reservado. Sólo para uso interno). Un abonado utiliza este
prioridad a la adquisición de eventos desde el lector de huellas
digitales exclusivamente. Sólo se permite un suscriptor con esta
prioridad. El proceso suscribiendo con esta prioridad debe tener
privilegios de administrador o ejecutar bajo la cuenta del sistema
local.

observaciones
Los miembros de esta enumeración son llamados por la propiedad de prioridad del objeto
DPFPCapture (página 36).

Información enumeración

Tipo biblioteca DigitalPersona One Touch para componentes de dispositivo


de Windows 1.0 LibraryDPFPDevX.dll

Enumeración DPFPEventHandlerStatusEnum
La enumeración DPFPEventHandlerStatusEnum define los códigos que se devuelven por el
DPFPEventHandlerStatus objeto para indicar el estado de una operación.

Sintaxis
Enum DPFPEventHandlerStatusEnum
{EventHandlerStatusSuccess = 0,
EventHandlerStatusFailure = 1,
End Enum

constantes

EventHandlerStatusSuccess Se realizó una operación con éxito.

EventHandlerStatusFailure Una operación ha fallado.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 74
desarrollador
Capítulo 5: Referencia API para desarrolladores de Enumeración DPFPDataPurposeEnum
Visual Basic

observaciones
Los miembros de esta enumeración son llamados por la propiedad del Estado
DPFPEventHandlerStatus objeto (página 51).

Información enumeración

Tipo biblioteca DigitalPersona One Touch para el control de


Windows 1.0 LibraryDPFPShrX.dll

Enumeración DPFPDataPurposeEnum
La enumeración DPFPDataPurposeEnum define el propósito para el que un conjunto de
características de huellas digitales es para ser utilizado.

Sintaxis
Enum DPFPDataPurposeEnum
{DataPurposeUnknown = 0,
DataPurposeVerification = 1,
DataPurposeEnrollment = 2,
End Enum

constantes

DataPurposeUnknown El propósito no es conocida.

DataPurposeVerification Una característica huella digital fija para ser utilizada con el propósito de
verificación.
DataPurposeEnrollment Una característica huella digital fija para ser utilizada con el propósito de la
inscripción.

observaciones
Los miembros de esta enumeración son llamados por el método de la CreateFeatureSet
DPFPFeatureExtraction objeto (página 52).

Información enumeración

Tipo biblioteca DigitalPersona One Touch para componentes de motor de


Windows 1.0 LibraryDPFPEngX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 75
desarrollador
Capítulo 5: Referencia API para desarrolladores de Enumeración DPFPReaderImpressionTypeEnum
Visual Basic

Enumeración DPFPReaderImpressionTypeEnum
La enumeración DPFPReaderImpressionTypeEnum define la modalidad que un lector de huellas
utiliza para capturar muestras de huellas digitales.

Sintaxis
Enum DPFPReaderImpressionTypeEnum
{ReaderImpressionTypeUnknown =
0,
ReaderImpressionTypeSwipe = 1,
ReaderImpressionTypeArea = 2,
End Enum

constantes

ReaderImpressionTypeUnknown Un lector de huellas dactilares para la que no se conoce la modalidad.


ReaderImpressionTypeSwipe Un lector swipe huella digital.
ReaderImpressionTypeArea Un lector de huellas digitales sensor de área (tacto).

observaciones
Los miembros de esta enumeración son llamados por la propiedad de la ImpressionType
DPFPReaderDescription objeto (página 55).

Información enumeración

Tipo biblioteca DigitalPersona One Touch para componentes de dispositivo


de Windows 1.0 LibraryDPFPDevX.dll

Enumeración DPFPReaderTechnologyEnum
La enumeración DPFPReaderTechnologyEnum define la tecnología de lector de huellas digitales.

Sintaxis
Enum DPFPReaderTechnologyEnum
{ReaderTechnologyUnknown = 0,
ReaderTechnologyOptical = 1,
ReaderTechnologyCapacitive = 2,
ReaderTechnologyThermal = 3,
ReaderTechnologyPressure = 4,
End Enum

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 76
desarrollador
Capítulo 5: Referencia API para desarrolladores de Enumeración DPFPSerialNumberTypeEnum
Visual Basic

constantes

ReaderTechnologyUnknown Un lector de huellas dactilares para la que no se conoce la tecnología.


ReaderTechnologyOptical Un lector óptico de huellas
dactilares. ReaderTechnologyCapacitive Un lector de
huellas dactilares capacitivo. ReaderTechnologyThermal Un
lector de huellas digitales térmico.

ReaderTechnologyPressure Un lector de huellas digitales de presión.

observaciones
Los miembros de esta enumeración son llamados por la propiedad de la Tecnología
DPFPReaderDescription objeto (página 56).

Información enumeración

Tipo biblioteca DigitalPersona One Touch para componentes de dispositivo

de Windows 1.0 LibraryDPFPDevX.dll

Enumeración DPFPSerialNumberTypeEnum
La enumeración DPFPSerialNumberTypeEnum define si un número de serie lector de huellas
digitales persiste después de reiniciar el sistema.

Sintaxis
Enum DPFPSerialNumberTypeEnum
{SerialNumberTypePersistent = 0,
SerialNumberTypeVolatile = 1,
End Enum

constantes

SerialNumberTypePersistent Un número de serie persistente proporcionada por el hardware.

SerialNumberTypeVolatile Un número de serie volátil proporcionada por el software.

observaciones
Los miembros de esta enumeración son llamados por la propiedad de la SerialNumberType
DPFPReaderDescription objeto (página 56).

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 77
desarrollador
Capítulo 5: Referencia API para desarrolladores de Enumeración DPFPTemplateStatusEnum
Visual Basic

Información enumeración

Tipo biblioteca DigitalPersona One Touch para componentes de dispositivo


de Windows 1.0 LibraryDPFPDevX.dll

Enumeración DPFPTemplateStatusEnum
La enumeración DPFPTemplateStatusEnum define el estado de una operación de huellas digitales
de creación de plantillas.

Sintaxis
Enum DPFPTemplateStatusEnum
{TemplateStatusUnknown = 0,
TemplateStatusInsufficient = 1,
TemplateStatusFailed = 2,
TemplateStatusReady = 3,
End Enum

constantes

TemplateStatusUnknown El estado de una operación de creación de plantillas no se conoce,


probablemente debido a una plantilla de huella digital no existe
todavía.
TemplateStatusInsufficient Existe una plantilla de huella digital, pero más conjuntos de
características de huellas digitales
son necesarios para su realización.
TemplateStatusFailed Una operación de creación de plantillas de huellas digitales falló.
TemplateStatusReady Una plantilla de huella digital fue creado y está listo para su uso.

observaciones
Los miembros de esta enumeración son llamados por la propiedad de la TemplateStatus
DPFPEnrollment objeto (página 42).

Información enumeración

Tipo biblioteca DigitalPersona One Touch para componentes de motor de

Windows 1.0 LibraryDPFPEngX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 78
desarrollador
Referencia API para C ++ Desarrolladores 6

En este capítulo se definen los componentes de la API que se utilizan para el desarrollo de
aplicaciones que incorporan la funcionalidad del One Touch para Windows: / ActiveX Edición API
en C ++ utilizando el modelo de objetos componentes (COM) de aplicación COM.

Interfaces
El One Touch para Windows: aplicación COM / ActiveX Edición COM API incluye la doble, no extensible
interfaces definidas en esta sección. Utilice la siguiente lista para localizar rápidamente una interfaz
por nombre, número de página, o por descripción.

IMPORTANTE: Todas las propiedades de lectura / escritura del One Touch para las interfaces API de
Windows SDK son opcionales. Si no configura una de estas propiedades, el valor por
defecto se utiliza de forma automática. Al decidir si se debe establecer una propiedad,
tenga en cuenta que DigitalPersona puede cambiar los valores por defecto en cualquier
momento sin previo aviso. Si desea que la funcionalidad de la aplicación para mantener
la coherencia, debe establecer las propiedades en consecuencia.

Interfaz Pági Descripción


na
IDPFPCapture 78 Utilizado por una aplicación para capturar una muestra
de la huella digital de un lector de huellas digitales

_IDPFPCaptureEvents 81 Designa una interfaz de receptor de eventos que una


aplicación debe aplicar para recibir notificaciones de
eventos de un objeto DPFPCapture

IDPFPData 83 Representa la funcionalidad de los datos que son


comunes a todos los objetos de datos de huellas
dactilares
IDPFPEnrollment 85 Utilizado por una aplicación para realizar la función
del sistema de registro de huellas dactilares

IDPFPEnrollmentControl 87 Representa la funcionalidad de un control ActiveX para


realizar operaciones de registro de huellas dactilares, y
proporciona una interfaz de usuario

_IDPFPEnrollmentControlEvents 91 Designa una interfaz de receptor de eventos que una


aplicación debe aplicar para recibir notificaciones de
eventos de un objeto DPFPEnrollmentControl

IDPFPEventHandlerStatus 96 Utilizado por una aplicación para recuperar los


códigos que indican el estado de una operación

IDPFPFeatureExtraction 97 Utilizado por una aplicación para realizar la función


del sistema de extracción de características de
huellas dactilares

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 79
desarrollador
Capítulo 6: Referencia API para C ++ Interfaces
Desarrolladores

Interfaz Pági Descripción


na
IDPFPFeatureSet 99 Representa la funcionalidad de un conjunto de
características de huellas digitales
IDPFPReaderDescription 101 Utilizada por una aplicación para obtener
información sobre un lector de huellas digitales
particular, conectado a un sistema
IDPFPReadersCollection 106 Representa una colección de lectores de huellas digitales
conectados a un sistema

IDPFPSample 109 Representa la funcionalidad de una muestra de la huella


digital
IDPFPSampleConversion 111 Utilizado por una aplicación para devolver una
muestra de la huella digital como una imagen

IDPFPTemplate 113 Representa la funcionalidad de una plantilla de huella


dactilar
IDPFPVerification 115 Utilizado por una aplicación para realizar la verificación
de huellas dactilares
IDPFPVerificationControl 118 Representa la funcionalidad de un control
ActiveX para crear y devolver un conjunto de
características de huellas digitales, y proporciona
una interfaz de usuario
_IDPFPVerificationControlEvents 120 Designa una interfaz de receptor de eventos que una
aplicación debe aplicar para recibir notificaciones de
eventos de un objeto DPFPVerificationControl

IDPFPVerificationResult 121 Representa la funcionalidad de los resultados de una


operación de verificación de huellas dactilares

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 80
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPCapture
Desarrolladores

Interfaz IDPFPCapture
Utilizado por una aplicación para capturar una muestra de la huella digital de un lector de huellas digitales. el
IDPFPCapture
interfaz proporciona métodos y propiedades para la captura de una muestra de la huella digital de un lector de
huellas digitales.

Los miembros IDPFPCapture

IDPFPCapture :: Propiedad Prioridad


Recupera o devuelve un valor que especifica la prioridad de una operación de captura

de la huella dactilar de la muestra. Esta propiedad es opcional. Si no se establece que,

se utiliza el valor CapturePriorityNormal.

Sintaxis
HRESULT IDPFPCapture :: get_Priority (
[Fuera, retval] DPFPCapturePriorityEnum * pVal
);
HRESULT IDPFPCapture :: put_Priority
([in] DPFPCapturePriorityEnum
newVal
);

parámetros

pVal [A cabo, retval] Puntero a una variable que recibe un valor que especifica la
prioridad de una operación de captura de muestra de lector de huellas
digitales. Para posibles valores, consulte el
DPFPCapturePriorityEnumpágina 125.
newVal [En] variable que contiene el valor que especifica la prioridad de una
operación de captura de muestra de lector de huellas digitales
Valores devueltos
Devuelve S_OK si tiene éxito, o el valor de error siguiente de otro modo:

Valor de retorno Mensaje Descripción

DISP_E_OVERFLOW Fuera de rango actual. Los datos apuntado por el parámetro de


salida está fuera del rango de valores
posibles.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 81
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPCapture
Desarrolladores

IDPFPCapture :: ReaderSerialNumber Propiedad


Recupera o devuelve el número de serie de un lector de huellas dactilares que captura una muestra de la huella
digital.

Esta propiedad es opcional. Si no se establece que, se utiliza el siguiente valor:


{} 00000000-0000-0000-0000-000000000000. Esto significa que la aplicación recibirá
eventos desde cualquiera de los lectores de huellas digitales conectados al sistema.

Sintaxis
HRESULT IDPFPCapture :: get_ReaderSerialNumber
([a cabo, retval] BSTR * pVal
);
HRESULT IDPFPCapture :: put_ReaderSerialNumber
([in] BSTR newVal
);

parámetros

pVal [A cabo, retval] Puntero a una variable de tipo BSTR que recibe un
número de serie lector de huellas digitales

newVal [En] variable de tipo BSTR que contiene el número de serie lector de huellas digitales

Valores devueltos
Devuelve S_OK si tiene éxito, o el valor de error siguiente de otro modo:

Valor de retorno Mensaje Descripción

E_INVALIDARG Uno o más argumentos El formato de la cadena que contiene el lector


no son válidos. de huellas número de serie es incorrecto.
Debe estar en formato GUID, por ejemplo,
{A9EFB3F6-841E-A8C8-4684-
4330973057C6}.

IDPFPCapture :: Método StartCapture


Empieza la captura de una muestra de la huella digital de un lector de huellas digitales. Una llamada a
este método es asincrónica y devuelve inmediatamente. La aplicación continúa para recibir eventos
hasta que el método IDPFPCapture :: StopCapture se llama o cuando el objeto DPFPCapture se
destruye.

Sintaxis
HRESULT StartCapture (void);

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 82
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPCapture
Desarrolladores

Valores devueltos
Devuelve S_OK si tiene éxito, o el valor de error siguiente de otro modo:

Valor de retorno Mensaje Descripción

E_INVALIDARG Uno o más argumentos Una operación de captura con la prioridad


no son válidos. especificada ya existe. Ver
DPFPCapturePriorityEnum enpágina 125 para
más información.

E_ACCESSDENIED El acceso general La aplicación no tiene suficientes privilegios para


denegado error. iniciar las operaciones de captura con la
prioridad especificada. Ver
DPFPCapturePriorityEnum enpágina 125 para
más información.

IDPFPCapture :: Método StopCapture


Detiene la operación de captura de huellas dactilares de la muestra comenzó con una llamada a la IDPFPCapture
:: StartCapture
método.

Sintaxis
HRESULT StopCapture (void);

Valor de retorno
Devuelve S_OK si tiene éxito.

Información de la interfaz

Personalizado implementación Sí
hereda desde IDispatch
Tipo libraryDigitalPersona One Touch para componentes de dispositivo de Windows 1.0
LibraryDPFPDevX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 83
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz _IDPFPCaptureEvents
Desarrolladores

Interfaz _IDPFPCaptureEvents
Designa una interfaz de receptor de eventos que una aplicación debe aplicar para recibir notificaciones de
eventos desde una
DPFPCapture objeto, que implementa la interfaz IDPFPCapture (página 78).

Los miembros _IDPFPCaptureEvents

_IDPFPCaptureEvents :: OnComplete eventos


Se activa cuando una muestra de la huella digital es capturado con éxito por un lector de huellas digitales.

Sintaxis
HRESULT OnComplete (
[In] BSTR ReaderSerNum,
[En] IDispatch * pFingerprintSample
);

parámetros

ReaderSerNum [En] variable de tipo BSTR que contiene una serie lector de huellas digitales
número
pFingerprintSample [En] Un objeto DPFPSample

_IDPFPCaptureEvents :: OnFingerGone eventos


Se activa cuando un usuario elimina un dedo de un lector de huellas digitales.

Sintaxis
HRESULT OnFingerGone
([in] BSTR
ReaderSerNum
);

Parámetro

ReaderSerNum [En] variable de tipo BSTR que contiene un número de serie lector de huellas
digitales

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 84
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz _IDPFPCaptureEvents
Desarrolladores

_IDPFPCaptureEvents :: Evento OnFingerTouch


Se activa cuando un usuario toca un lector de huellas digitales.

Sintaxis
HRESULT OnFingerTouch
([in] BSTR
ReaderSerNum
);

Parámetro

ReaderSerNum [En] variable de tipo BSTR que contiene un número de serie lector de huellas
digitales

_IDPFPCaptureEvents :: OnReaderConnect eventos


Se activa cuando un lector de huellas digitales está unido a un sistema.

Sintaxis
HRESULT OnReaderConnect
([in] BSTR
ReaderSerNum
);

Parámetro

ReaderSerNum [En] variable de tipo BSTR que contiene un número de serie lector de huellas
digitales

_IDPFPCaptureEvents :: OnReaderDisconnect eventos


Se activa cuando un lector de huellas dactilares se desconecta de un sistema.

Sintaxis
HRESULT OnReaderDisconnect
([in] BSTR ReaderSerNum
);

Parámetro

ReaderSerNum [En] variable de tipo BSTR que contiene un número de serie lector de huellas
digitales

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 85
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPData
Desarrolladores

_IDPFPCaptureEvents :: OnSampleQuality eventos


Se activa cuando se verifica la calidad de una muestra de la huella digital. Cuando
SampleQualityGood es devuelto por este evento, el evento _IDPFPCaptureEvents :: onComplete se
dispara (página 81).

Sintaxis
HRESULT OnSampleQuality
([in] BSTR ReaderSerNum,
[En] DPFPCaptureFeedbackEnum SampleQuality
);

parámetros

ReaderSerNum [En] variable de tipo BSTR que contiene un número de serie lector de huellas
digitales
SampleQuality [En] Variable que contiene un valor que proporciona información sobre
una operación de la huella digital de captura de muestra. Para posibles
valores, consulte el DPFPCaptureFeedbackEnumpágina 124.

Interfaz IDPFPData
Representa la funcionalidad de los datos que es común a todosobjetos de datos de huellas digitales. el
IDPFPData
interfaz también proporciona métodos para serializar y deserializar objetos de datos de huellas digitales.

Los miembros IDPFPData

IDPFPData :: Método Deserialize


Deserializa un objeto de datos de huellas dactilares devuelto por el método IDPFPData :: Serialize.

Sintaxis
HRESULT Deserialize
([in] VARIANT RawData
);

Parámetro

RawData [En] Variant matriz de bytes (VT_U1 o VT_ARRAY) que


contiene un objeto de datos de huellas dactilares deserializado

Valores devueltos
Devuelve S_OK si tiene éxito, o el valor de error siguiente de otro modo:

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 86
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPData
Desarrolladores

Valor de retorno Mensaje Descripción

E_INVALIDARG Uno o más argumentos El formato de los datos que se pasan a la


no son válidos. Deserialize método es incorrecta.
S_FALSE conjuntos de características no se pueden
agregar porque la plantilla de huellas dactilares
ya se ha creado.

IDPFPData :: Método Serialize


Serializa un objeto de datos de huellas dactilares y la devuelve como una matriz de bytes.

Sintaxis
HRESULT Serialize (
[Fuera, retval] VARIANTE * pRawData
);

Parámetro

pRawData [A cabo, retval] Puntero a una matriz de variante de bytes (VT_U1 o


VT_ARRAY) que recibe un objeto de datos de huellas dactilares
serializado

Valor de retorno
Devuelve S_OK si tiene éxito.

Información de la interfaz

Personalizado implementación Sí
hereda desde IDispatch
Tipo libraryDigitalPersona One Touch para los componentes compartidos de Windows 1.0

LibraryDPFPShrX.dll

Ver también
Interfaz IDPFPFeatureSet en la página 99
Interfaz IDPFPSample en la página 109
Interfaz IDPFPTemplate en la página 113

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 87
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPEnrollment
Desarrolladores

Interfaz IDPFPEnrollment
Utilizado por una aplicación para realizar la función del sistema de registro de huellas dactilares. La
interfaz IDPFPEnrollment proporciona métodos y propiedades para la creación de una plantilla de
huellas dactilares de un número determinado de conjuntos de características de huellas digitales
creados para el propósito de la inscripción.

Los miembros IDPFPEnrollment

IDPFPEnrollment :: addFeatures Método


Añade conjuntos de características de huellas digitales, uno por uno, a una plantilla de huella dactilar.
Una llamada a este método crea una instancia de DPFPTemplate, que representa una plantilla de
huella dactilar. El objeto DPFPTemplate implementa la interfaz IDPFPTemplate (página 113). La
plantilla de huellas dactilares se completa cuando la propiedad TemplateStatus se establece en el
valor TemplateStatusReady.

Sintaxis
AddFeatures HRESULT
([en] IDispatch *
pVal
);

Parámetro

pVal [En] objeto A DPFPFeatureSet

Valor de retorno
Devuelve S_OK si tiene éxito.

IDPFPEnrollment :: Borrar Método


Borra una plantilla de huella digital y define el valor de la propiedad a TemplateStatus
TemplateStatusUnknown por lo que una aplicación puede iniciar otra operación de creación de plantillas de
huellas digitales.

Sintaxis
Claro HRESULT (void);

Valor de retorno
Devuelve S_OK si tiene éxito.

IDPFPEnrollment :: FeaturesNeeded Propiedad


Recupera el número de conjuntos de características de huellas dactilares todavía se necesitan para
crear una plantilla de huellas dactilares. Cuando el valor del parámetro pVal es igual a 0, se crea la
plantilla de huellas dactilares. Esta propiedad se de sólo lectura y no tiene valor predeterminado.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 88
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPEnrollment
Desarrolladores

Sintaxis
HRESULT IDPFPEnrollment :: get_FeaturesNeeded
([a cabo, retval] LARGO * pVal
);

Parámetro

pVal [A cabo, retval] puntero a una variable de tipo long que recibe el valor del
número de conjuntos de características de huellas digitales

Valor de retorno
Devuelve S_OK si tiene éxito.

IDPFPEnrollment :: Plantilla de la propiedad


Recupera un objeto DPFPTemplate creado durante una operación de registro de huellas dactilares.
Esta propiedad está sólo lectura y no tiene valor predeterminado.

Sintaxis
HRESULT IDPFPEnrollment :: get_template
([a cabo, retval] IDispatch ** pVal
);

Parámetro

pVal [A cabo, retval] Un objeto DPFPTemplate

Valor de retorno
Devuelve S_OK si tiene éxito.

IDPFPEnrollment :: TemplateStatus Propiedad


Recupera un valor que especifica el estado de una operación de creación de plantillas de huellas
digitales. Esta propiedad está sólo lectura y no tiene valor predeterminado.

Sintaxis
HRESULT IDPFPEnrollment :: get_TemplateStatus
([a cabo, retval] DPFPTemplateStatusEnum *
pVal
);

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 89
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPEnrollmentControl
Desarrolladores

Parámetro

pVal [A cabo, retval] Puntero a una variable que recibe un valor que especifica
el estado de la operación de huellas digitales de creación de plantillas.
Para posibles valores, consulte el DPFPTemplateStatusEnumpágina 130.

Valor de retorno
Devuelve S_OK si tiene éxito.

Información de la interfaz

Personalizado implementación Sí
hereda desde IDispatch
Tipo libraryDigitalPersona One Touch para componentes de motor de Windows 1.0
LibraryDPFPEngX.dll

Interfaz IDPFPEnrollmentControl
Representa la funcionalidad de un control ActiveX, que implementa una interfaz de usuario
(descrito en DPFPEnrollmentControl objeto de interfaz de usuario en la página 131). La interfaz
IDPFPEnrollmentControl proporciona la siguiente funcionalidad:
 Captura muestras de huellas digitales de un lector de huellas digitales (s)
 Crea conjuntos de características de huellas digitales para el propósito de la inscripción
 Crea plantillas de huellas dactilares
 Notifica a una aplicación cuando el afiliado se compromete a eliminar una plantilla de huella digital
 eventos incendios

Los miembros IDPFPEnrollmentControl

IDPFPEnrollmentControl :: EnrolledFingersMask Propiedad


Recupera o devuelve la máscara que representa huellas digitales registradas del usuario. La máscara
de la inscripción es una combinación de los valores que representan las huellas digitales incluidas de
un usuario. Por ejemplo, si el derecho huella del dedo índice de un usuario y la huella digital media
derecha están inscritos, el valor de esta propiedad es 00000000 011 000 000, o 192.

Esta propiedad es opcional. Si no se establece que, el valor 0 se utiliza, lo que significa que no hay
huellas digitales se han inscrito.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 90
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPEnrollmentControl
Desarrolladores

Sintaxis
HRESULT IDPFPEnrollmentControl ::
get_EnrolledFingersMask ([a cabo, retval] LARGO * pVal
);
HRESULT IDPFPEnrollmentControl ::
put_EnrolledFingersMask ([in] LARGO newVal
);

parámetros

pVal [A cabo, retval] puntero a una variable de tipo long que recibe el valor
de la máscara de huellas dactilares
newVal [En] Variable de tipo long que contiene el valor de la máscara de huellas dactilares

Valores posibles
Todos los valores posibles para la máscara de la inscripción se enumeran en la Tabla 6.

Tabla 6. Los valores para la máscara de la matrícula

Dedo La representación binaria Representación de


enteros
meñique izquierda 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 dieci


séis
Pulgar derecho 000000000 000100000 32

dedo índice derecho 000000000 001000000 64

dedo medio derecho 000000000 010000000 128

dedo anular derecho 000000000 100000000 256

meñique derecho 000000001 000000000 512

Valores devueltos
Devuelve S_OK si tiene éxito, o el valor de error siguiente de otro modo:

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 91
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPEnrollmentControl
Desarrolladores

Valor de retorno Mensaje Descripción

DISP_E_OVERFLOW Fuera de rango actual. Los datos apuntado por el parámetro de


salida está fuera del rango de valores
posibles.

IDPFPEnrollmentControl :: MaxEnrollFingerCount Propiedad


Recupera o devuelve el valor para el número máximo de huellas digitales que pueden ser inscrito. Los
valores posibles para este parámetro son 1 a 10.

Esta propiedad es opcional. Si no se establece que, se utiliza el valor 10, lo que significa que el
usuario puede inscribir a todos los diez huellas dactilares.

Sintaxis
HRESULT IDPFPEnrollmentControl :: get_MaxEnrollFingerCount
([a cabo, retval] LARGO * pVal
);
HRESULT IDPFPEnrollmentControl :: put_MaxEnrollFingerCount
([in] LARGO newVal
);

parámetros

pVal [A cabo, retval] puntero a una variable de tipo long que recibe el valor
para el número máximo de huellas dactilares que puede ser inscrito

newVal [En] Variable de tipo long que contiene el valor para el número máximo
de huellas dactilares que puede ser inscrito
Valores devueltos
Devuelve S_OK si tiene éxito, o el valor de error siguiente de otro modo:

Valor de retorno Mensaje Descripción


DISP_E_OVERFLOW Fuera de rango actual. Los datos apuntado por el parámetro de
salida está fuera del rango de valores
posibles.

IDPFPEnrollmentControl :: ReaderSerialNumber Propiedad


Recupera o devuelve el número de serie del lector de huellas digitales desde el que se capturó una muestra de la
huella digital.

Esta propiedad es opcional. Si no se establece que, se utiliza el siguiente valor:


{} 00000000-0000-0000-0000-000000000000. Esto significa que la aplicación recibirá
eventos desde cualquiera de los lectores de huellas digitales conectados al sistema.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 92
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPEnrollmentControl
Desarrolladores

Sintaxis
HRESULT IDPFPEnrollmentControl ::
get_ReaderSerialNumber ([a cabo, retval] BSTR * pVal
);
HRESULT IDPFPEnrollmentControl ::
put_ReaderSerialNumber ([in] BSTR newVal
);

parámetros

pVal [A cabo, retval] Puntero a una variable de tipo BSTR que recibe el número
de serie lector de huellas digitales
newVal [En] variable de tipo BSTR que contiene el número de serie lector de huellas digitales

Valores devueltos
Devuelve S_OK si tiene éxito, o el valor de error siguiente de otro modo:

Valor de retorno Mensaje Descripción

E_INVALIDARG Uno o más argumentos El formato de la cadena que contiene el lector


no son válidos. de huellas número de serie es incorrecto.
Debe estar en formato GUID, por ejemplo,
{A9EFB3F6-841E-A8C8-4684-
4330973057C6}.

Información de la interfaz

Personalizado implementación Sí

hereda desde IDispatch


Tipo libraryDigitalPersona One Touch para el control de Windows 1.0

LibraryDPFPCtlX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 93
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz _IDPFPEnrollmentControlEvents
Desarrolladores

Interfaz _IDPFPEnrollmentControlEvents
Designa una interfaz de receptor de eventos que una aplicación debe aplicar para recibir
notificaciones de eventos de un objeto DPFPEnrollmentControl, que implementa la interfaz
IDPFPEnrollmentControl (página 87).

Los miembros _IDPFPEnrollmentControlEvents

_IDPFPEnrollmentControlEvents :: OnCancelEnroll eventos


Se activa cuando la inscripción se cancela.

Sintaxis
HRESULT OnCancelEnroll
([in] BSTR
pSerialNumber, [en] LONG
lEnrolledFinger
);

parámetros
pSerialNumber [En] Variable de BSTR tipo que contiene un número de serie lector de huellas
digitales.
lEnrolledFinger [En] valor de índice dedo incluido, en la norma ANSI / NIST-ITL 1.
Para posibles valores, consulte Tabla 7 en la página 92.

_IDPFPEnrollmentControlEvents :: OnComplete eventos


Disparó contra una exploración exitosa.

Sintaxis
HRESULT OnComplete (
[In] BSTR pSerialNumber,
[en] LONG lEnrolledFinger
);

parámetros
pSerialNumber [En] Variable de BSTR tipo que contiene un número de serie lector de huellas
digitales.
lEnrolledFinger [En] valor de índice dedo incluido, en la norma ANSI / NIST-ITL 1.
Para posibles valores, consulte Tabla 7 en la página 92.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 94
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz _IDPFPEnrollmentControlEvents
Desarrolladores

_IDPFPEnrollmentControlEvents :: OnDelete eventos


Se activa cuando un usuario se compromete a eliminar una huella digital registrada. La
aplicación se encarga de 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 de error.

Sintaxis
HRESULT OnDelete (
[En] LARGO 1FingerMask,
[en] IDispatch * pStatus
);

parámetros

1FingerMask [In] Puntero a una variable de tipo long que contiene el valor del
índice de la huella dactilar (inscrito) a eliminar. Para posibles
valores, consulteMesa 7.
pStatus [En] objeto A DPFPEventHandlerStatus

los uFingerMask parámetro es el valor de índice del dedo asociado con una huella digital para
ser inscrito o una plantilla de huella dactilar se va a eliminar, tal como se definen en la norma ANSI
/ NIST-ITL 1. Los valores de índice se asignan a la representación gráfica de los dedos en las
manos en el interfaz de usuario. Todos los valores posibles se enumeran enMesa 7.

Tabla 7. los valores de índice de dedo en ANSI / NIST-ITL 1

Dedo Índice de Dedo Índice de


Valor Valor
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

meñique derecho 5 meñique izquierda 10

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 95
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz _IDPFPEnrollmentControlEvents
Desarrolladores

_IDPFPEnrollmentControlEvents :: Evento OnEnroll


Se activa cuando un usuario se inscribe una huella digital y devuelve una plantilla de huella dactilar. La
aplicación se ocupa del 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 de
error.

Sintaxis
HRESULT OnEnroll (
[En] LONG 1FingerMask,
[En] IDispatch *
pFingerprintTemplate, [en] IDispatch
* pStatus
);

parámetros

1FingerMask [En] Variable de tipo long que contiene el valor de índice para el inscrito
huella dactilar. Para posibles valores, consulteTabla 7 en la página 92.
pFingerprintTemplate [En] Un objeto DPFPTemplate

pStatus [En] objeto A DPFPEventHandlerStatus

_IDPFPEnrollmentControlEvents :: OnFingerRemove eventos


Se activa cuando un usuario elimina un dedo de un lector de huellas digitales.

Sintaxis
HRESULT OnFingerRemove
([in] BSTR
pSerialNumber, [en] LONG
lEnrolledFinger
);

parámetros
pSerialNumber [En] Variable de BSTR tipo que contiene un número de serie lector de huellas
digitales.
lEnrolledFinger [En] valor de índice dedo incluido, en la norma ANSI / NIST-ITL 1.
Para posibles valores, consulte Tabla 7 en la página 92.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 96
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz _IDPFPEnrollmentControlEvents
Desarrolladores

_IDPFPEnrollmentControlEvents :: Evento OnFingerTouch


Se activa cuando un usuario toca un lector de huellas digitales.

Sintaxis
HRESULT OnFingerTouch
([in] BSTR
pSerialNumber,
[En] LONG lEnrolledFinger
);

parámetros
pSerialNumber [En] Variable de BSTR tipo que contiene un número de serie lector de huellas
digitales.
lEnrolledFinger [En] valor de índice dedo incluido, en la norma ANSI / NIST-ITL 1.
Para posibles valores, consulte Tabla 7 en la página 92.

_IDPFPEnrollmentControlEvents :: OnReaderConnect eventos


Se activa cuando se conecta un lector.

Sintaxis
HRESULT OnReaderConnect
([in] BSTR pSerialNumber,
[en] LONG lEnrolledFinger
);

parámetros
pSerialNumber [En] Variable de BSTR tipo que contiene un número de serie lector de huellas
digitales.
lEnrolledFinger [En] valor de índice dedo incluido, en la norma ANSI / NIST-ITL 1.
Para posibles valores, consulte Tabla 7 en la página 92.

_IDPFPEnrollmentControlEvents :: OnReaderDisconnect eventos


Se activa cuando se desconecta un lector.

Sintaxis
HRESULT OnReaderDisconnect
([in] BSTR pSerialNumber,
[en] LONG lEnrolledFinger
);

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 97
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz _IDPFPEnrollmentControlEvents
Desarrolladores

parámetros
pSerialNumber [En] Variable de BSTR tipo que contiene un número de serie lector de huellas
digitales.
lEnrolledFinger [En] valor de índice dedo incluido, en la norma ANSI / NIST-ITL 1.
Para posibles valores, consulte Tabla 7 en la página 92.

_IDPFPEnrollmentControlEvents :: OnSampleQuality eventos


Se activa cuando se recibe una muestra de la huella digital.

Sintaxis
HRESULT OnSampleQuality
([in] BSTR pSerialNumber,
[en] LONG lEnrolledFinger
[en] lSampleQuality LONG
);

parámetros
pSerialNumber [En] Variable de BSTR tipo que contiene un número de serie lector de huellas
digitales.
lEnrolledFinger [En] valor de índice dedo incluido, en la norma ANSI / NIST-ITL 1.
Para posibles valores, consulte Tabla 7 en la página 92.
lSampleQuality [En] Variable que contiene un valor que proporciona información sobre
una operación de la huella digital de captura de muestra. Para posibles
valores, consulteDPFPCaptureFeedbackEnum tipo enumerado en la página
124.

_IDPFPEnrollmentControlEvents :: Evento OnStartEnroll


Se activa cuando la inscripción ha comenzado.

Sintaxis
HRESULT OnStartEnroll
([in] BSTR
pSerialNumber,
[En] LONG lEnrolledFinger
);

parámetros
pSerialNumber [En] Variable de BSTR tipo que contiene un número de serie lector de huellas
digitales.
lEnrolledFinger [En] valor de índice dedo incluido, en la norma ANSI / NIST-ITL 1.
Para posibles valores, consulte Tabla 7 en la página 92.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 98
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz _IDPFPEventHandlerStatus
Desarrolladores

Interfaz _IDPFPEventHandlerStatus
Utilizado por una aplicación para recuperar los códigos que indican el estado de una operación.

IDPFPEventHandlerStatus miembro

IDPFPEventHandlerStatus :: Propiedad Condición


Recupera o devuelve el estado de una operación realizada por un objeto DPFPEnrollmentControl,
que implementa la interfaz IDPFPEnrollmentControl (página 87), O un objeto
DPFPVerificationControl, que implementa la interfaz IDPFPVerificationControl (página 118).

Esta propiedad es opcional. Si no se establece que, se utiliza el valor DPFPEventHandlerStatusSuccess.

Sintaxis
HRESULT IDPFPEventHandlerStatus :: get_status
([a cabo, retval] DPFPEventHandlerStatusEnum *
pVal
);
HRESULT IDPFPEventHandlerStatus :: put_Status
([in] DPFPEventHandlerStatusEnum newVal
);

parámetros

pVal [A cabo, retval] Puntero a una variable que recibe un valor que indica el
estado de una operación. Para posibles valores, consulte el
DPFPEventHandlerStatusEnumpágina 126.
newVal [En] variable que contiene el valor que indica el estado de una operación

Valores devueltos
Devuelve S_OK si tiene éxito, o el valor de error siguiente de otro modo:

Valor de retorno Mensaje Descripción

DISP_E_OVERFLOW Fuera de rango actual. Los datos apuntado por el parámetro de


salida está fuera del rango de valores
posibles.

Información de la interfaz

Personalizado implementación Sí

hereda desde IDispatch

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 99
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPFeatureExtraction
Desarrolladores

Tipo libraryDigitalPersona One Touch para el control de Windows 1.0


LibraryDPFPCtlX.dll

Interfaz IDPFPFeatureExtraction
Utilizado por una aplicación para realizar extracción de características de huellas digitales. La interfaz
IDPFPFeatureExtraction proporciona un método y una propiedad para la creación de una
característica de huellas digitales establecido para el propósito de la inscripción o la verificación
mediante la aplicación de extracción de características de huellas digitales para una muestra de la
huella digital.

Los miembros IDPFPFeatureExtraction

IDPFPFeatureExtraction :: Método CreateFeatureSet


Se aplica la extracción de características de huellas digitales para una muestra de la huella digital y
luego crea una característica de huellas digitales fijado para el fin indicado. Una llamada a este
método crea una instancia de DPFPFeatureSet, que representa un conjunto de características de
huellas digitales. El objeto DPFPFeatureSet implementa la interfaz IDPFPFeatureSet (página 99).

Sintaxis
HRESULT CreateFeatureSet (
[En] IDispatch * pFingerprintSample,
[en] DPFPDataPurposeEnum Propósito,
[Fuera, retval] DPFPCaptureFeedbackEnum * pSampleQuality
);

parámetros

pFingerprintSample [En] Un objeto DPFPSample


Propósito [En] Variable que contiene un valor para el propósito especificado.
Para posibles valores, consulte el DPFPDataPurposeEnumpágina
127.
pSampleQuality [A cabo, retval] Puntero a una variable que recibe un valor que proporciona
comentarios acerca de una operación de captura de la huella
dactilar de la muestra. para su posiblevalores, ver en
DPFPCaptureFeedbackEnum página 124.

Valor de retorno
Devuelve S_OK si tiene éxito.

IDPFPFeatureExtraction :: FeatureSet Propiedad


Recupera un objeto DPFPFeatureSet creado durante una operación de extracción de características
de huellas digitales. Esta propiedad se de sólo lectura y no tiene valor predeterminado.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 10
desarrollador 0
Capítulo 6: Referencia API para C ++ Interfaz IDPFPFeatureExtraction
Desarrolladores

Sintaxis
HRESULT IDPFPFeatureExtraction :: get_FeatureSet
([a cabo, retval] IDispatch ** pVal
);

Parámetro

pVal [A cabo, retval] Un objeto DPFPFeatureSet

Valores devueltos
Devuelve S_OK si tiene éxito, o el valor de error siguiente de otro modo:

Valor de retorno Mensaje Descripción

DISP_E_MEMBERNOTFOUND Miembro no Un conjunto de características de huellas


encontrado. digitales no se ha creado todavía.

Información de la interfaz

Personalizado implementación Sí
hereda desde IDispatch
Tipo libraryDigitalPersona One Touch para componentes de motor de Windows 1.0

LibraryDPFPEngX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 10
desarrollador 1
Capítulo 6: Referencia API para C ++ Interfaz IDPFPFeatureSet
Desarrolladores

Interfaz IDPFPFeatureSet
Representa la funcionalidad de un conjunto de características de huellas digitales. Un objeto
DPFPFeatureSet, que representa un conjunto de características de huellas digitales, implementa la
interfaz IDPFPFeatureSet.

Los miembros IDPFPFeatureSet

IDPFPFeatureSet :: Método Deserialize


Deserializa un objeto de datos de huellas dactilares devuelto por el método IDPFPFeatureSet :: Serialize.

Sintaxis
HRESULT Deserialize
([in] VARIANT RawData
);

Parámetro

RawData [En] Variant matriz de bytes (VT_U1 o VT_ARRAY) que


contiene un objeto de datos de huellas dactilares deserializado

Valores devueltos
Devuelve S_OK si tiene éxito, o el valor de error siguiente de otro modo:

Valor de retorno Mensaje Descripción

E_INVALIDARG Uno o más argumentos El formato de los datos que se pasan a la


no son válidos. Deserialize método es incorrecta.

S_FALSE conjuntos de características no se pueden


agregar porque la plantilla de huellas dactilares
ya se ha creado.

IDPFPFeatureSet :: Método Serialize


Serializa un objeto de datos de huellas dactilares y la devuelve como una matriz de bytes.

Sintaxis
HRESULT Serialize (
[Fuera, retval] VARIANTE * pRawData
);

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 10
desarrollador 2
Capítulo 6: Referencia API para C ++ Interfaz IDPFPFeatureSet
Desarrolladores

Parámetro

pRawData [A cabo, retval] Puntero a una matriz de variante de bytes (VT_U1 o


VT_ARRAY) que recibe un objeto de datos de huellas dactilares
serializado

Valor de retorno
Devuelve S_OK si tiene éxito.

Información de la interfaz

Personalizado implementación Sí
hereda desde IDPFPData
Tipo libraryDigitalPersona One Touch para los componentes compartidos de Windows 1.0
LibraryDPFPShrX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 10
desarrollador 3
Capítulo 6: Referencia API para C ++ Interfaz IDPFPReaderDescription
Desarrolladores

Interfaz IDPFPReaderDescription
Utilizada por una aplicación para obtener información sobre un lector de huellas digitales particular,
conectado a un sistema, tal como su tecnología o número de serie.

Los miembros IDPFPReaderDescription

IDPFPReaderDescription :: FirmwareRevision Propiedad


Recupera el número de revisión del firmware de un lector de huellas digitales. Esta propiedad se de
sólo lectura y no tiene valor predeterminado.

Sintaxis
HRESULT IDPFPReaderDescription :: get_FirmwareRevision
([a cabo, retval] BSTR * pVal
);

Parámetro

pVal [In] Puntero a una variable de tipo BSTR la recibe el número de revisión de
firmware lector de huellas digitales

Valor de retorno
Devuelve S_OK si tiene éxito.

IDPFPReaderDescription :: HardwareRevision Propiedad


Recupera el número de revisión del hardware de un lector de huellas digitales. Esta propiedad se de
sólo lectura y no tiene valor predeterminado.

Sintaxis
HRESULT IDPFPReaderDescription :: get_HardwareRevision
([a cabo, retval] BSTR * pVal
);

Parámetro

pVal [In] Puntero a una variable de tipo BSTR que recibe el hardware lector de
huellas digitales número de revisión

IDPFPReaderDescription :: Lenguaje Propiedad


Recupera el idioma lector de huellas digitales. El valor del parámetro pVal es siempre 0x409, que es
Inglés.Esta propiedad se de sólo lectura y no tiene valor predeterminado.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 10
desarrollador 4
Capítulo 6: Referencia API para C ++ Interfaz IDPFPReaderDescription
Desarrolladores

Sintaxis
HRESULT IDPFPReaderDescription :: get_Language
([a cabo, retval] LARGO * pVal
);

Parámetro

pVal [In] Puntero a una variable de tipo BSTR que recibe el idioma lector de huellas digitales

Valor de retorno
Devuelve S_OK si tiene éxito.

IDPFPReaderDescription :: ImpressionType Propiedad


Recupera un valor que especifica el tipo de impresión lector de huellas digitales, por ejemplo, lector swipe o
táctil (área) lector. Esta propiedad se de sólo lectura y no tiene valor predeterminado.

Sintaxis
HRESULT IDPFPReaderDescription :: get_ImpressionType
([a cabo, retval] DPFPReaderImpressionTypeEnum *
pVal
);

Parámetro

pVal [In] Puntero a una variable que recibe un valor que especifica la modalidad
lector de huellas digitales. Para posibles valores, consulte el
DPFPReaderImpressionTypeEnumpágina 128.

Valor de retorno
Devuelve S_OK si tiene éxito.

IDPFPReaderDescription :: ProductName Propiedad


Recupera el nombre del producto de un lector de huellas digitales, por ejemplo, “U.are.U.” Esta propiedad
es de sólo lectura y no tiene valor por defecto.

Sintaxis
HRESULT IDPFPReaderDescription :: get_ProductName
([a cabo, retval] BSTR * pVal
);

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 10
desarrollador 5
Capítulo 6: Referencia API para C ++ Interfaz IDPFPReaderDescription
Desarrolladores

Parámetro

pVal [In] Puntero a una variable de tipo BSTR que recibe el nombre de producto
lector de huellas digitales

Valor de retorno
Devuelve S_OK si tiene éxito.

IDPFPReaderDescription :: SerialNumber Propiedad


Recupera el número de serie de un lector de huellas digitales. Esta propiedad se de sólo lectura y no tiene valor
predeterminado.

Sintaxis
HRESULT IDPFPReaderDescription :: get_SerialNumber
([a cabo, retval] BSTR * pVal
);

Parámetro

pVal [In] Puntero a una variable de tipo BSTR la recibe el número de serie
lector de huellas digitales

Valor de retorno
Devuelve S_OK si tiene éxito.

IDPFPReaderDescription :: SerialNumberType Propiedad


Recupera un valor que especifica el tipo de número de serie lector de huellas digitales. Esta
propiedad se de sólo lectura y no tiene valor predeterminado.

Sintaxis
HRESULT IDPFPReaderDescription :: get_SerialNumberType
([a cabo, retval] DPFPSerialNumberTypeEnum * pVal
);

Parámetro

pVal [In] Puntero a una variable que recibe un valor que especifica el lector de
huellas digitales tipo de número de serie. Para posibles valores, consulte el
DPFPSerialNumberTypeEnumpágina 129.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 10
desarrollador 6
Capítulo 6: Referencia API para C ++ Interfaz IDPFPReaderDescription
Desarrolladores

Valor de retorno
Devuelve S_OK si tiene éxito.

IDPFPReaderDescription :: Tecnología Propiedad


Recupera un valor que especifica la tecnología lector de huellas digitales. Esta propiedad se de sólo
lectura y no tiene valor predeterminado.

Sintaxis
HRESULT IDPFPReaderDescription :: get_Technology
([a cabo, retval] DPFPReaderTechnologyEnum * pVal
);

Parámetro

pVal [In] Puntero a una variable que recibe un valor que especifica la tecnología
lector de huellas digitales. Para posibles valores, consulte el
DPFPReaderTechnologyEnumpágina 128.

Valor de retorno
Devuelve S_OK si tiene éxito.

IDPFPReaderDescription :: Vendedor Propiedad


Recupera el nombre del proveedor para un lector de huellas digitales, por ejemplo, “DigitalPersona, Inc.”
Esta propiedad es de sólo lectura y no tiene ningún valor predeterminado.

Sintaxis
HRESULT IDPFPReaderDescription :: get_Vendor
([a cabo, retval] BSTR * pVal
);

Parámetro

pVal [In] Puntero a una variable de tipo BSTR la recibe el nombre del
proveedor lector de huellas digitales

Valor de retorno
Devuelve S_OK si tiene éxito.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 10
desarrollador 7
Capítulo 6: Referencia API para C ++ Interfaz IDPFPReaderDescription
Desarrolladores

Información de la interfaz

Personalizado implementación Sí
hereda desde IDispatch
Tipo libraryDigitalPersona One Touch para componentes de dispositivo de Windows 1.0

LibraryDPFPDevX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 10
desarrollador 8
Capítulo 6: Referencia API para C ++ Interfaz IDPFPReadersCollection
Desarrolladores

Interfaz IDPFPReadersCollection
Representa una colección de lectores de huellas digitales conectados a un sistema. La interfaz
IDPFPReadersCollection proporciona un método y propiedades para enumerar lectores de huellas
dactilares, para recuperar un lector de huellas digitales particular usando su valor de índice o de su
número de serie, y para informar el número total de lectores de huellas digitales.

Los miembros IDPFPReadersCollection

IDPFPReadersCollection :: Método lector


Crea una instancia de DPFPReaderDescription para un lector de huellas digitales particular
usando su número de serie. El objeto DPFPReaderDescription implementa la interfaz
IDPFPReaderDescription (página 101).

Sintaxis
HRESULT Reader (
[In] BSTR ReaderSerialNum, [a
cabo, retval] IDispatch **
ppReader
);

parámetros

ReaderSerialNumber [En] variable de tipo BSTR que contiene un número de serie lector de huellas
digitales
ppReader [A cabo, retval] Un objeto DPFPReaderDescription

Valores devueltos
Devuelve S_OK si tiene éxito, o el valor de error siguiente de otro modo:

Valor de retorno Mensaje Descripción

_HRESULT_FROM_WIN32 El sistema no puede El lector de huellas dactilares con el


(ERROR_FILE_NOT_FOUND) encontrar el archivo número de serie especificado no se
especificado. puede encontrar en el sistema.

IDPFPReadersCollection :: Count Propiedad


Recupera el número total de objetos DPFPReaderDescription (artículos) conectadas a un sistema
(una colección). Esta propiedad se de sólo lectura y no tiene valor predeterminado.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 10
desarrollador 9
Capítulo 6: Referencia API para C ++ Interfaz IDPFPReadersCollection
Desarrolladores

Sintaxis
HRESULT IDPFPReadersCollection :: get_Count
([a cabo, retval] LARGO * pVal
);

Parámetro

pVal [In] Puntero a una variable de tipo long que recibe el número total de
DPFPReaderDescription objetos

Valor de retorno
Devuelve S_OK si tiene éxito.

IDPFPReadersCollection :: Item Propiedad


Recupera un objeto DPFPReaderDescription (un elemento) a partir de los lectores de huellas
digitales conectados a un sistema (una colección) usando su índice. El valor del parámetro pVal
comienza con 1.

Sintaxis
HRESULT IDPFPReadersCollection :: get_Item ([a
cabo, retval] IDispatch ** pVal
);

Parámetro

pVal [A cabo, retval] Un objeto DPFPReaderDescription

Valores devueltos
Devuelve S_OK si tiene éxito, o el valor de error siguiente de otro modo:

Valor de retorno Mensaje Descripción

DISP_E_BADINDEX índice no válido. El índice especificado no está en el rango válido de 1 a


Contar.

IDPFPReadersCollection :: _ NewEnum Propiedad


Recupera un puntero IUnknown al objeto ReaderEnum (objeto enumeración), que es una matriz de
DPFPReaderDescription objetos. Esta propiedad se de sólo lectura y no tiene valor predeterminado.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 11
desarrollador 0
Capítulo 6: Referencia API para C ++ Interfaz IDPFPReadersCollection
Desarrolladores

Sintaxis
HRESULT IDPFPReadersCollection :: get NewEnum
([a cabo, retval] IUnknown ** pVal
);

Parámetro

pVal [In] Puntero a una variable de tipo IUnknown que recibe el conjunto de
DPFPReaderDescription objetos

Valor de retorno
Devuelve S_OK si tiene éxito.

Información de la interfaz

Personalizado implementación Sí

hereda desde IDispatch


Tipo libraryDigitalPersona One Touch para componentes de dispositivo de Windows 1.0
LibraryDPFPDevX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 11
desarrollador 1
Capítulo 6: Referencia API para C ++ Interfaz IDPFPSample
Desarrolladores

Interfaz IDPFPSample
Representa la funcionalidad de una muestra de huella dactilar captada de un lector de huellas digitales. Un
DPFPSample
objeto, que representa una muestra de huella digital, implementa la interfaz IDPFPSample.

Los miembros IDPFPSample

IDPFPSample :: Método Deserialize


Deserializa un objeto de datos de huellas dactilares devuelto por el método IDPFPSample :: Serialize.

Sintaxis
HRESULT Deserialize
([in] VARIANT RawData
);

Parámetro

RawData [En] Variant matriz de bytes (VT_U1 o VT_ARRAY) que


contiene un objeto de datos de huellas dactilares deserializado

Valores devueltos
Devuelve S_OK si tiene éxito, o el valor de error siguiente de otro modo:

Valor de retorno Mensaje Descripción

E_INVALIDARG Uno o más argumentos El formato de los datos que se pasan a la


no son válidos. Deserialize método es incorrecta.
S_FALSE conjuntos de características no se pueden
agregar porque la plantilla de huellas dactilares
ya se ha creado.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 11
desarrollador 2
Capítulo 6: Referencia API para C ++ Interfaz IDPFPSample
Desarrolladores

IDPFPSample :: Método Serialize


Serializa un objeto de datos de huellas dactilares y la devuelve como una matriz de bytes.

Sintaxis
HRESULT Serialize (
[Fuera, retval] VARIANTE * pRawData
);

Parámetro

pRawData [A cabo, retval] Puntero a una matriz de variante de bytes (VT_U1 o


VT_ARRAY) que recibe un objeto de datos de huellas dactilares
serializado

Valor de retorno
Devuelve S_OK si tiene éxito.

Información de la interfaz

Personalizado implementación Sí
hereda desde IDPFPData
Tipo libraryDigitalPersona One Touch para los componentes compartidos de Windows 1.0

LibraryDPFPShrX.dll

Ver también
Interfaz IDPFPData en la página 83

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 110
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPSampleConversion
Desarrolladores

Interfaz IDPFPSampleConversion
Utilizado por una aplicación para convertir una muestra de la huella digital a una imagen. La interfaz
IDPFPSampleConversion proporciona métodos para el retorno de una muestra de huella digital
como un objeto IPicture y como una imagen en ANSI formato 381.

Los miembros IDPFPSampleConversion

IDPFPSample :: Método ConvertToANSI381


Convierte una muestra de huellas digitales para una imagen en formato ANSI 381.

HRESULT ConvertToANSI381 (
[En] IDispatch * pSample, [a cabo,
retval] VARIANTE * Pansi
);

parámetros

pSample [En] Un objeto DPFPSample

Pansi [A cabo, retval] Puntero a una matriz de variante de bytes (VT_U1 o


VT_ARRAY) que recibe una imagen en ANSI formato 381
Valor de retorno
Devuelve S_OK si tiene éxito.

IDPFPSample :: Método ConvertToPicture


Convierte una muestra de huellas digitales a un objeto IPicture.

Sintaxis
HRESULT ConvertToPicture
([in] IDispatch *
pSample,
[A cabo, retval] IDispatch ** ppPicture
);

parámetros

pSample [En] Un objeto DPFPSample


ppPicture [A cabo, retval] Un objeto IPicture

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 111
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPSampleConversion
Desarrolladores

Valor de retorno
Devuelve S_OK si tiene éxito.

Información de la interfaz

Personalizado implementación Sí
hereda desde IDispatch
Tipo libraryDigitalPersona One Touch para componentes de dispositivo de Windows 1.0

LibraryDPFPDevX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 112
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPTemplate
Desarrolladores

Interfaz IDPFPTemplate
Representa la funcionalidad de una plantilla de huella dactilar. Un objeto DPFPTemplate, que
representa una plantilla de huella dactilar, implementa la interfaz IDPFPTemplate.

Los miembros IDPFPTemplate

IDPFPTemplate :: Método Deserialize


Deserializa un objeto de datos de huellas dactilares devuelto por el método IDPFPTemplate :: Serialize.

Sintaxis
HRESULT Deserialize
([in] VARIANT RawData
);

Parámetro

RawData [En] Variant matriz de bytes (VT_U1 o VT_ARRAY) que


contiene un objeto de datos de huellas dactilares deserializado

Valores devueltos
Devuelve S_OK si tiene éxito, o el valor de error siguiente de otro modo:

Valor de retorno Mensaje Descripción

E_INVALIDARG Uno o más argumentos El formato de los datos que se pasan a la


no son válidos. Deserialize método es incorrecta.

S_FALSE conjuntos de características no se pueden


agregar porque la plantilla de huellas dactilares
ya se ha creado.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 113
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPTemplate
Desarrolladores

IDPFPTemplate :: Método Serialize


Serializa un objeto de datos de huellas dactilares y la devuelve como una matriz de bytes.

Sintaxis
HRESULT Serialize (
[Fuera, retval] VARIANTE * pRawData
);

Parámetro

pRawData [A cabo, retval] Puntero a una matriz de variante de bytes (VT_U1 o


VT_ARRAY) que recibe un objeto de datos de huellas dactilares
serializado

Valor de retorno
Devuelve S_OK si tiene éxito.

Información de la interfaz

Personalizado implementación Sí
hereda desde IDPFPData
Tipo libraryDigitalPersona One Touch para los componentes compartidos de Windows 1.0

LibraryDPFPShrX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 114
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPVerification
Desarrolladores

Interfaz IDPFPVerification
Utilizado por una aplicación para realizar la función del sistema de verificación de huellas dactilares. La
interfaz IDPFPVerification proporciona un método y una propiedad para realizar la verificación de
huellas dactilares, que es una comparación de uno a uno de una característica de huellas dactilares
de conjunto con una plantilla de huella digital producida en la inscripción que devuelve una decisión
de partido o no partido.

Los miembros IDPFPVerification

IDPFPVerification :: propiedad Activo


Activa / desactiva la captura de huellas dactilares. El valor predeterminado es TRUE.

Sintaxis
HRESULT IDPFPVerification :: get_active
([a cabo, retval] VARIANT_BOOL * pVal
);

HRESULT IDPFPVerification :: set_active


([in] VARIANT_BOOL newVal
);

parámetros

pVal [A cabo, retval] puntero a una variable de tipo long que recibe el valor
de la solicitada FAR

newVal [En] Variable de tipo long que contiene el valor de la solicitada FAR

Valores devueltos
Devuelve S_OK si tiene éxito.

IDPFPVerification :: FARRequested Propiedad


Recupera o devuelve la tasa de aceptar la falsa solicitada (FAR). Para una explicación general de las
FAR, véaseFalso Los falsos positivos y negativos en la página 19.

Esta propiedad es opcional. Si no se establece que, se utiliza el valor por defecto. Se puede utilizar el
FARRequested
propiedad para verificar o modificar el valor actual de las FAR.

IMPORTANTE: Aunque el valor por defecto es adecuada para la mayoría de las aplicaciones, es
posible que necesite un valor inferior o superior para satisfacer sus necesidades. Si
decide utilizar un valor distinto del predeterminado, asegúrese de que entiende las
consecuencias de hacerlo. Referirse aApéndice A en la página 147 para obtener más
información sobre cómo establecer el valor de las FAR.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 115
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPVerification
Desarrolladores

Sintaxis
HRESULT IDPFPVerification :: get_FARRequested
([a cabo, retval] LARGO * pVal
);
HRESULT IDPFPVerification :: put_FARRequested
([in] LARGO newVal
);

parámetros

pVal [A cabo, retval] puntero a una variable de tipo long que recibe el valor
de la solicitada FAR
newVal [En] Variable de tipo long que contiene el valor de la solicitada FAR

Valores devueltos
Devuelve S_OK si tiene éxito, o el valor de error siguiente de otro modo:

Valor de retorno Mensaje Descripción

DISP_E_OVERFLOW Fuera de rango actual. Los datos apuntado por el parámetro de


salida está fuera del rango de valores
posibles.

IDPFPVerification :: verificar el método


Realiza la función del sistema de verificación de huellas dactilares y devuelve una decisión basada
en la comparación de lo solicitado FAR establecido por la propiedad IDPFPVerification ::
FARRequested.

Sintaxis
Hresult Verify (
[En] IDispatch * pVerificationFeatureSet,
[en] IDispatch * pFingerprintTemplate,
[A cabo, retval] IDispatch ** ppVerificationResult
);

parámetros

pFeatureSet [En] Un objeto DPFPFeatureSet, donde el parámetro Propósito de


el método IDPFPFeatureExtraction :: CreateFeatureSet se
establece en el valor DataPurposeVerification (página 97)

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 116
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPVerification
Desarrolladores

pTemplate [En] Un objeto DPFPTemplate


ppVerificationResult [A cabo, retval] Un objeto DPFPVerificationResult

Valor de retorno
Devuelve S_OK si tiene éxito.

Información de la interfaz

Personalizado implementación Sí

hereda desde IDispatch


Tipo libraryDigitalPersona One Touch para componentes de motor de Windows 1.0
LibraryDPFPEngX.dll

Ver también
Interfaz IDPFPVerificationResult en la página 121

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 117
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPVerificationControl
Desarrolladores

Interfaz IDPFPVerificationControl
Representa la funcionalidad de un control ActiveX, que implementa una interfaz de usuario (descrito
en DPFPEnrollmentControl objeto de interfaz de usuario en la página 131). La interfaz
IDPFPVerificationControl proporciona la siguiente funcionalidad:
 Recibe lector de huellas digitales conectar y desconectar las notificaciones de eventos
 Captura muestras de huellas digitales de un lector de huellas digitales (s)
 Crea conjuntos de características de huellas digitales para el propósito de la verificación
 Se dispara un evento

Los miembros IDPFPVerificationControl

IDPFPVerificationControl :: propiedad Activo


Activa / desactiva la captura de huellas dactilares. El valor predeterminado es TRUE.

Sintaxis
HRESULT IDPFPVerification :: get_active
([a cabo, retval] VARIANT_BOOL * pVal
);

HRESULT IDPFPVerification :: set_active


([in] VARIANT_BOOL newVal
);

parámetros

pVal [A cabo, retval] Puntero a una variable de tipo booleano que recibe el estado de captura

newVal [En] variable de tipo booleano que contiene el valor de la condición de


captura solicitada
Valores devueltos
Devuelve S_OK si tiene éxito.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 118
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPVerificationControl
Desarrolladores

IDPFPVerificationControl :: ReaderSerialNumber Propiedad


Recupera o devuelve el número de serie del lector de huellas digitales desde el que se capturó una muestra de la
huella digital.

Esta propiedad es opcional. Si no se establece que, se utiliza el siguiente valor:


{} 00000000-0000-0000-0000-000000000000. Esto significa que la aplicación recibirá
eventos desde cualquiera de los lectores de huellas digitales conectados al sistema.

Sintaxis
HRESULT IDPFPVerificationControl :: get_ReaderSerialNumber
([a cabo, retval] BSTR * pVal
);
HRESULT IDPFPVerificationControl :: put_ReaderSerialNumber
([in] BSTR newVal
);

parámetros

pVal [A cabo, retval] Puntero a una variable de tipo BSTR que recibe el número
de serie lector de huellas digitales

newVal [En] variable de tipo BSTR que contiene el número de serie lector de huellas digitales

Valores devueltos
Devuelve S_OK si tiene éxito, o el valor de error siguiente de otro modo:

Valor de retorno Mensaje Descripción

E_INVALIDARG Uno o más argumentos El formato de la cadena que contiene el lector


no son válidos. de huellas número de serie es incorrecto.
Debe estar en formato GUID, por ejemplo,
{A9EFB3F6-841E-A8C8-4684-
4330973057C6}.

Información de la interfaz

Personalizado implementación Sí

hereda desde IDispatch


Tipo libraryDigitalPersona One Touch para el control de Windows 1.0
LibraryDPFPCtlX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 119
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz _IDPFPVerificationControlEvents
Desarrolladores

Interfaz _IDPFPVerificationControlEvents
Designa una interfaz de receptor de eventos que una aplicación debe aplicar para recibir notificaciones
de eventos de un objeto DPFPVerificationControl, que implementa la interfaz IDPFPVerificationControl
(página 118).

Los miembros _IDPFPVerificationControlEvents

_IDPFPVerificationControlEvents :: OnComplete eventos


Se activa cuando un conjunto de características de huellas dactilares creado con el propósito de
verificación está listo para la comparación y devuelve el conjunto de características de huellas
dactilares. La aplicación se encarga de la comparación de la huella digital característica conjunto con
una plantilla de huellas dactilares.

Sintaxis
HRESULT OnComplete (
[En] IDispatch * pVerificationFeatureSet,
[en] IDispatch * pStatus
);

parámetros

pVerificationFeatureSet [En] objeto A DPFPFeatureSet


pStatus [En] objeto A DPFPEventHandlerStatus

Valor de retorno
Devuelve S_OK si tiene éxito.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 120
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPVerificationResult
Desarrolladores

Interfaz IDPFPVerificationResult
Representa la funcionalidad de los resultados de una operación de verificación de huellas dactilares.
Un objeto DPFPVerificationResult, que representa los resultados de una operación de verificación de
huellas dactilares, implementa la interfaz IDPFPVerificationResult. La interfaz IDPFPVerificationResult
proporciona propiedades para recuperar los resultados de una operación de verificación de huellas
dactilares.

Los miembros IDPFPVerificationResult

IDPFPVerificationResult :: FARAchieved Propiedad


Recupera el valor de las FAR alcanzado por una operación de comparación. Esta propiedad es de sólo
lectura y no tienevalor por defecto. VerConseguido FAR en la página 149 para más información sobre
esta propiedad.

Sintaxis
HRESULT IDPFPVerificationResult :: get_FARAchieved
([a cabo, retval] LARGO * pVal
);

Parámetro

pVal [A cabo, retval] puntero a una variable de tipo long que recibe el valor de
la FAR que se logró para la comparación

Valor de retorno
Devuelve S_OK si tiene éxito.

IDPFPVerificationResult :: verificado la propiedad


Recupera la decisión de comparación, que indica si la comparación de un conjunto de características
de huellas digitales y una plantilla de huella dactilar resultaron en una decisión de partido o no
partido. Esta decisión se basa en el valor establecido por la propiedad IDPFPVerification ::
FARRequested (página 115). La propiedad IDPFPVerificationResult :: verificado es de sólo lectura y
no tiene valor predeterminado.

Sintaxis
HRESULT IDPFPVerificationResult ::
get_Verified ([a cabo, retval] VARIANT_BOOL
* pVal
);

Parámetro

pVal [A cabo, retval] Puntero a una variante de boolean tipo que recibe la
decisión de comparación. Los valores posibles son verdad para una
decisión de partido o falsa de una decisión de no coincidencia.
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 121
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPVerificationResult
Desarrolladores

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 122
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPVerificationResult
Desarrolladores

Valor de retorno
Devuelve S_OK si tiene éxito.

Información de la interfaz

Personalizado implementación Sí
hereda desde IDispatch
Tipo libraryDigitalPersona One Touch para componentes de motor de Windows 1.0

LibraryDPFPEngX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 123
desarrollador
Capítulo 6: Referencia API para C ++ enumeracion
Desarrolladores es

enumeraciones
El One Touch para Windows: aplicación COM / ActiveX Edición COM API incluye los tipos enumerados se
define en esta sección. Utilice la siguiente lista para localizar rápidamente un tipo enumerado por
nombre, número de página, o por descripción.

Método Pági Descripción


na
DPFPCaptureFeedbackEnum 124 Eventos devueltos por un lector de huellas digitales que
proporcionan información acerca de una operación de
captura de la huella dactilar de la muestra
DPFPCapturePriorityEnum 125 Prioridad de una operación de captura de la huella dactilar
de la muestra
DPFPEventHandlerStatusEnum 126 Códigos que se devuelven por el DPFPEventHandlerStatus
objeto para indicar el estado de una operación

DPFPDataPurposeEnum 127 Propósito para el cual un conjunto de características de


huellas digitales es para ser utilizado
DPFPReaderImpressionTypeEnum 128 Modalidad que utiliza un lector de huellas digitales para
capturar muestras de huellas digitales

DPFPReaderTechnologyEnum 128 tecnología de lector de huellas digitales

DPFPSerialNumberTypeEnum 129 Lector de huellas dactilares número de serie persistencia


después de reiniciar
DPFPTemplateStatusEnum 130 Estado de una operación de creación de plantillas de huellas
digitales

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 124
desarrollador
Capítulo 6: Referencia API para C ++ DPFPCaptureFeedbackEnum tipo enumerado
Desarrolladores

DPFPCaptureFeedbackEnum tipo enumerado


El tipo enumerado DPFPCaptureFeedbackEnum define los eventos devueltos por un lector de huellas
dactilares que proporcionan retroalimentación sobre una operación de la huella digital de captura de
muestra.

Sintaxis
typedef enum {DPFPCaptureFeedbackEnum
CaptureFeedbackGood = 0,
CaptureFeedbackNone = 1,
CaptureFeedbackTooLight = 2,
CaptureFeedbackTooDark = 3,
CaptureFeedbackTooNoisy = 4,
CaptureFeedbackLowContrast = 5,
CaptureFeedbackNotEnoughFtrs = 6,
CaptureFeedbackNoCentralRgn = 7,
CaptureFeedbackNoFinger = 8,
CaptureFeedbackTooHigh = 9,
CaptureFeedbackTooLow = 10,
CaptureFeedbackTooLeft = 11,
CaptureFeedbackTooRight = 12,
CaptureFeedbackTooStrange = 13,
CaptureFeedbackTooFast = 14,
CaptureFeedbackTooSkewed = 15,
CaptureFeedbackTooShort = 16,
CaptureFeedbackTooSlow = 17,
DPFPCaptureFeedbackEnum};

constantes

CaptureFeedbackGood La muestra de la huella digital es de buena calidad.

CaptureFeedbackNone No hay ninguna muestra de la huella


digital. CaptureFeedbackTooLight La muestra de la huella digital es
demasiado clara. CaptureFeedbackTooDark La muestra de la huella
digital es demasiado oscura CaptureFeedbackTooNoisy La muestra de la
huella digital es demasiado ruidoso. CaptureFeedbackLowContrast El
contraste de la muestra de huella digital es demasiado bajo.

CaptureFeedbackNotEnoughFtrs La muestra de la huella digital no contiene suficiente


información.
CaptureFeedbackNoCentralRgn La muestra de la huella digital no está centrada.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 125
desarrollador
Capítulo 6: Referencia API para C ++ DPFPCapturePriorityEnum tipo enumerado
Desarrolladores

CaptureFeedbackNoFinger El objeto escaneado no es un dedo.


CaptureFeedbackTooHigh El dedo era demasiado alta en el sensor
más fuerte. CaptureFeedbackTooLow El dedo era demasiado bajo en el sensor
más fuerte.

CaptureFeedbackTooLeft El dedo estaba demasiado cerca del borde izquierdo del golpe
sensor.
CaptureFeedbackTooRight El dedo estaba demasiado cerca del borde derecho del golpe
sensor.
CaptureFeedbackTooStrange La exploración tiene un aspecto
extraño. CaptureFeedbackTooFast El dedo se limpió con demasiada
rapidez. CaptureFeedbackTooSkewed La muestra de la huella digital es
demasiado sesgada. CaptureFeedbackTooShort La muestra de la
huella digital es demasiado corto.

CaptureFeedbackTooSlow El dedo se limpió con demasiada lentitud.

observaciones
Los miembros de este tipo enumerado son llamados por el
IDPFPFeatureExtraction :: CreateFeatureSet método (página 97) Y por el
_IDPFPCaptureEvents :: OnSampleQuality evento (página 83).

Enumerado Tipo de Información

Tipo biblioteca DigitalPersona One Touch para los componentes compartidos


de Windows 1.0 LibraryDPFPShrX.dll

DPFPCapturePriorityEnum tipo enumerado


El tipo DPFPCapturePriorityEnum enumerado define la prioridad de una operación de captura de
muestra de la huella digital realizado por un lector de huellas digitales.

Sintaxis
typedef enum {DPFPCapturePriorityEnum
CapturePriorityLow = 0,
CapturePriorityNormal = 1,
CapturePriorityHigh = 2,
DPFPCapturePriorityEnum};

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 126
desarrollador
Capítulo 6: Referencia API para C ++ DPFPEventHandlerStatusEnum tipo enumerado
Desarrolladores

constantes

CapturePriorityLow Baja prioridad. Una aplicación utiliza esta prioridad para adquirir eventos de
el lector de huellas digitales sólo si no hay abonados con
prioridad alta o normal. Sólo se permite un suscriptor con
esta prioridad.
CapturePriorityNormal prioridad normal. Una aplicación utiliza esta prioridad para adquirir eventos de
el lector de huellas digitales sólo si la operación se ejecuta
en un proceso en primer plano. se permiten múltiples
suscriptores con esta prioridad.
CapturePriorityHigh Alta prioridad. (Reservado. Sólo para uso interno). Un abonado utiliza este
prioridad a la adquisición de eventos desde el lector de huellas
digitales exclusivamente. Sólo se permite un suscriptor con esta
prioridad. El proceso suscribiendo con esta prioridad debe tener
privilegios de administrador o ejecutar bajo la cuenta del sistema
local.

observaciones
Los miembros de este tipo enumerado son llamados por la propiedad IDPFPCapture ::
Prioridad (página 78).

Enumerado Tipo de Información

Tipo biblioteca DigitalPersona One Touch para componentes de dispositivo


de Windows 1.0 LibraryDPFPDevX.dll

DPFPEventHandlerStatusEnum tipo enumerado


El tipo enumerado DPFPEventHandlerStatusEnum define los códigos que son devueltos por el
DPFPEventHandlerStatus objeto para indicar el estado de una operación.

Sintaxis
typedef enum {DPFPEventHandlerStatusEnum
EventHandlerStatusSuccess = 0,
EventHandlerStatusFailure = 1,
DPFPEventHandlerStatusEnum};

constantes

EventHandlerStatusSuccess Se realizó una operación con éxito.

EventHandlerStatusFailure Una operación ha fallado.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 127
desarrollador
Capítulo 6: Referencia API para C ++ DPFPDataPurposeEnum tipo enumerado
Desarrolladores

observaciones
Los miembros de este tipo enumerado son llamados por el IDPFPEventHandlerStatus :: Estado
propiedad (página 96).

Enumerado Tipo de Información

Tipo biblioteca DigitalPersona One Touch para el control de

Windows 1.0 LibraryDPFPShrX.dll

DPFPDataPurposeEnum tipo enumerado


El tipo DPFPDataPurposeEnum enumerado define el propósito para el que un conjunto de
características de huellas digitales es para ser utilizado.

Sintaxis
typedef enum {DPFPDataPurposeEnum
DataPurposeUnknown = 0,
DataPurposeVerification = 1,
DataPurposeEnrollment = 2,
DPFPDataPurposeEnum};

constantes

DataPurposeUnknown El propósito no es conocida.

DataPurposeVerification Una característica huella digital fija para ser utilizada con el propósito de
verificación.
DataPurposeEnrollment Una característica huella digital fija para ser utilizada con el propósito de la
inscripción.

observaciones
Los miembros de este tipo enumerado son llamados por el
IDPFPFeatureExtraction :: CreateFeatureSet método (página 97).

Enumerado Tipo de Información

Tipo biblioteca DigitalPersona One Touch para componentes de motor de


Windows 1.0 LibraryDPFPEngX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 128
desarrollador
Capítulo 6: Referencia API para C ++ DPFPReaderImpressionTypeEnum tipo enumerado
Desarrolladores

DPFPReaderImpressionTypeEnum tipo enumerado


El tipo DPFPReaderImpressionTypeEnum enumerado define la modalidad que un lector de huellas
utiliza para capturar muestras de huellas digitales.

Sintaxis
typedef enum {DPFPReaderImpressionTypeEnum
ReaderImpressionTypeUnknown = 0,
ReaderImpressionTypeSwipe = 1,
ReaderImpressionTypeArea = 2,
DPFPReaderImpressionTypeEnum};

constantes

ReaderImpressionTypeUnknown Un lector de huellas dactilares para la que no se conoce la modalidad.


ReaderImpressionTypeSwipe Un lector swipe huella digital.
ReaderImpressionTypeArea Un lector de huellas digitales sensor de área (tacto).

observaciones
Los miembros de este tipo enumerado son llamados por el
IDPFPReaderDescription :: ImpressionType propiedad (página 102).

Enumerado Tipo de Información

Tipo biblioteca DigitalPersona One Touch para componentes de dispositivo

de Windows 1.0 LibraryDPFPDevX.dll

DPFPReaderTechnologyEnum tipo enumerado


El tipo DPFPReaderTechnologyEnum enumerado define la tecnología de lector de huellas digitales.

Sintaxis
typedef enum {DPFPReaderTechnologyEnum
ReaderTechnologyUnknown = 0,
ReaderTechnologyOptical = 1,
ReaderTechnologyCapacitive = 2,
ReaderTechnologyThermal = 3,
ReaderTechnologyPressure = 4,
DPFPReaderTechnologyEnum};

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 129
desarrollador
Capítulo 6: Referencia API para C ++ DPFPSerialNumberTypeEnum tipo enumerado
Desarrolladores

constantes

ReaderTechnologyUnknown Un lector de huellas dactilares para la que no se conoce la tecnología.


ReaderTechnologyOptical Un lector óptico de huellas
dactilares. ReaderTechnologyCapacitive Un lector de
huellas dactilares capacitivo. ReaderTechnologyThermal Un
lector de huellas digitales térmico.

ReaderTechnologyPressure Un lector de huellas digitales de presión.

observaciones
Los miembros de este tipo enumerado son llamados por el IDPFPReaderDescription :: Tecnología
propiedad (página 104).

Enumerado Tipo de Información

Tipo biblioteca DigitalPersona One Touch para componentes de dispositivo


de Windows 1.0 LibraryDPFPDevX.dll

DPFPSerialNumberTypeEnum tipo enumerado


El tipo enumerado DPFPSerialNumberTypeEnum define si un número de serie lector de huellas
digitales persiste después de reiniciar el sistema.

Sintaxis
typedef enum {DPFPSerialNumberTypeEnum
SerialNumberTypePersistent = 0,
SerialNumberTypeVolatile = 1,
DPFPSerialNumberTypeEnum};

constantes

SerialNumberTypePersistent Un número de serie persistente proporcionada por el hardware.


SerialNumberTypeVolatile Un número de serie volátil proporcionada por el software.

observaciones
Los miembros de este tipo enumerado son llamados por el
IDPFPReaderDescription :: SerialNumberType propiedad (página 103).

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 130
desarrollador
Capítulo 6: Referencia API para C ++ DPFPTemplateStatusEnum tipo enumerado
Desarrolladores

Enumerado Tipo de Información

Tipo biblioteca DigitalPersona One Touch para componentes de dispositivo


de Windows 1.0 LibraryDPFPDevX.dll

DPFPTemplateStatusEnum tipo enumerado


El tipo DPFPTemplateStatusEnum enumerado define el estado de una operación de huellas digitales
de creación de plantillas.

Sintaxis
typedef enum {DPFPTemplateStatusEnum
TemplateStatusUnknown = 0,
TemplateStatusInsufficient = 1,
TemplateStatusFailed = 2,
TemplateStatusReady = 3,
DPFPTemplateStatusEnum};

constantes

TemplateStatusUnknown El estado de una operación de creación de plantillas no se conoce,


probablemente debido a una plantilla de huella digital no existe
todavía.
TemplateStatusInsufficient Existe una plantilla de huella digital, pero más conjuntos de
características de huellas digitales
son necesarios para su realización.
TemplateStatusFailed Una operación de creación de plantillas de huellas digitales falló.

TemplateStatusReady Una plantilla de huella digital fue creado y está listo para su uso.

observaciones
Los miembros de este tipo enumerado son llamados por el IDPFPEnrollment :: TemplateStatus
propiedad (página 86).

Enumerado Tipo de Información

Tipo biblioteca DigitalPersona One Touch para componentes de motor de


Windows 1.0 LibraryDPFPEngX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 130
desarrollador
Usuario Interfaz 7

En este capítulo se describe la funcionalidad de las interfaces de usuario incluidos en los objetos siguientes
componentes:
 DPFPEnrollmentControl
Este objeto incluye la interfaz de usuario se describe en la siguiente sección. Los métodos y las
propiedades de este objeto se describen en laspágina 43 para Visual Basic y en página 85 y
página 91 para C ++.
 DPFPVerificationControl
Este objeto incluye la interfaz de usuario se describe en página 140. Los métodos y las
propiedades de este objeto se describen en laspágina 64 para Visual Basic y página 118 y página
120 para C ++.

DPFPEnrollmentControl objeto de interfaz de usuario


La interfaz de usuario incluido con el objeto DPFPEnrollmentControl consta de dos elementos. El
primer elemento se utiliza para proporcionar instrucciones para seleccionar una huella digital para
inscribirse o cancelar la inscripción (eliminar) y se utiliza para indicar las huellas digitales incluidas ya.
El segundo elemento se utiliza para proporcionar instrucciones y la retroalimentación, tanto
gráficamente como textualmente, sobre el proceso de inscripción.

Las tablas y figura de esta sección describen la interacción entre el usuario y la interfaz de usuario
durante el registro de huellas dactilares y unenrollment (supresión).

NOTA: En las tablas, los elementos se conocen como el elemento de manos y el elemento de números.

Registro de una huella digital


Figura 9 ilustra el proceso de registro de huellas dactilares utilizando la interfaz de objeto
DPFPEnrollmentControl. números de imagen en la figura corresponden a las imágenes enMesa 8 en
la página 133. Mesa 8 ilustra y describe la interacción entre el usuario y la interfaz de usuario durante el
registro de huellas dactilares.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 131
desarrollador
Capítulo 7: Interfaz de Registro de una
usuario huella digital

comi
enzo

Foto 1

El usuario hace clic dedo


Usuario hace clic desmatriculados
en el dedo
imagen 12

Máximo de plantillas creadas ¿Máximo?

No

No
foto 2 imagen 11
de huellas creado
de características

El usuario hace
primer conjunto

Cancelar Sí
Esperando que el clic aquí
usuario
la Ir al inicio
inscripción?

4A o 4B foto
No Conjunt
mensaje de
o de
globo caracterí
sticas de
No
imagen 3 imagen 11
El usuario hace Sí
conjunto segunda

Esperando que el Cancelar


clic aquí la Ir al inicio
usuario
característica

inscripción?
huella digital

mensaje de globo No Conjunt


como en la imagen o de
4A o 4B caracterí
sticas de
No
imagen 5 imagen 11
El usuario hace Sí
características de

Esperando que el Cancelar


clic aquí la
Ir al inicio
usuario
inscripción?
conjunto de
En tercer

mensaje de globo No Conjunt


como en la imagen o de
4A o 4B caracterí
sticas de
No
imagen 6 imagen 11
El usuario hace Sí
En cuarto lugar

Esperando que el Cancelar


plantilla de huella digital de la huella digital creada y huella digital inscrito

clic aquí la Ir al inicio


usuario
conjunto de

inscripción?

mensaje de globo No Conjunt


como en la imagen o de
4A o 4B caracterí
sticas de
No
foto 7 imagen 11
El usuario hace Cancelar Sí
Esperando que el clic aquí
usuario la Ir al inicio
inscripción?

imagen 10
No Aceptar
mensaje de
globo plantill
a?

foto 8

plantilla creada

foto 9

mensaje de
globo

Fin

La Figura 9. Registro de una huella digital mediante la interfaz de usuario objeto DPFPControlEnrollment

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 132
desarrollador
Capítulo 7: Interfaz de Registro de una
usuario huella digital

Mesa 8. DPFPEnrollmentControl interfaz de usuario del objeto: Registro de una huella digital
Interfaz de usuario las acciones del usuario y la retroalimentación
interfaz de usuario
Foto 1 Esta imagen indica que no hay huellas digitales se han
inscrito, porque los dedos asociados con huellas
digitales registradas son de color verde.

foto 2 El usuario hace clic en el dedo índice derecho, y el


control se pasa de las manos el elemento al
elemento de números.
El elemento de los números está listo para
inscribirse índice de huella digital derecho del
usuario, como se indica por el dedo verde en la
mano en la esquina inferior izquierda.

imagen 3 El usuario toca el lector de huellas digitales, y un


conjunto de características de huellas digitales se ha
creado.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 133
desarrollador
Capítulo 7: Interfaz de Registro de una
usuario huella digital

Tabla 8. DPFPEnrollmentControl interfaz de usuario del objeto: Registro de una huella digital (continuación)
Interfaz de usuario las acciones del usuario y la retroalimentación
interfaz de usuario
cuadro 4A El usuario toca el lector de huellas digitales, sino un
conjunto de características de huellas digitales no fue
creado. El mensaje que se muestra depende de la
calidad de la muestra de la huella digital, como se
muestra en imágenes 4A y 4B.

foto 4B

imagen 5 El usuario toca el lector de huellas digitales, y un


segundo conjunto de características de huellas
digitales se ha creado.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 134
desarrollador
Capítulo 7: Interfaz de Registro de una
usuario huella digital

Tabla 8. DPFPEnrollmentControl interfaz de usuario del objeto: Registro de una huella digital (continuación)
Interfaz de usuario las acciones del usuario y la retroalimentación
interfaz de usuario
imagen 6 El usuario toca el lector de huellas digitales, y
un tercer conjunto de características de huellas
digitales se ha creado.

foto 7 El usuario toca el lector de huellas digitales, y un


cuarto conjunto de características de huellas
digitales se ha creado.

foto 8 Cuando se crea una plantilla de huella dactilar


para el dedo seleccionado, el control se pasa al
elemento de manos.
Esta imagen aparece cuando se dispara el evento
OnEnroll del objeto DPFPEnrollmentControl y
devuelve un estado de EventHandlerStatusSuccess.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 135
desarrollador
Capítulo 7: Interfaz de Registro de una
usuario huella digital

Tabla 8. DPFPEnrollmentControl interfaz de usuario del objeto: Registro de una huella digital (continuación)
Interfaz de usuario las acciones del usuario y la retroalimentación
interfaz de usuario
foto 9 El elemento de manos indica que el índice de
huellas dactilares derecho está inscrito, es
decir, el dedo es de color verde.
El valor de la propiedad es EnrolledFingersMask
000000000 001000000, O 64.

imagen 10 Una plantilla de huella digital no se ha creado para


el dedo seleccionado.
El usuario es instruido para intentarlo de nuevo, y
el control se mantiene con el elemento de
números.

imagen 11 Este mensaje aparece cuando el usuario haga clic aquí


Haga clic aquí para cancelar la inscripción. Cuando el
usuario hace clic en No, estoel mensaje se descarta y
se devuelve el control al elemento de números.
Cuando el usuario hace clic en Sí, este mensaje se
descarta y se pasa el control al elemento de manos.
El usuario puede cancelar la inscripción en cualquier
momento haciendo clic aquí y luego haciendo clic en
Sí.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 136
desarrollador
Capítulo 7: Interfaz de Registro de una
usuario huella digital

Tabla 8. DPFPEnrollmentControl interfaz de usuario del objeto: Registro de una huella digital (continuación)
Interfaz de usuario las acciones del usuario y la retroalimentación
interfaz de usuario
imagen 12 Este mensaje aparece cuando un usuario que ya ha
inscrito el número máximo permitido de las huellas
dactilares (establecido por la propiedad
MaxEnrollFingerCount) hace clic en un dedo
asociado con un dedo no registrado en el elemento
de manos. Cuando el usuario hace clic en Aceptar,
se devuelve el control al elemento de manos.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 137
desarrollador
Capítulo 7: Interfaz de Eliminación de una plantilla
usuario de huellas dactilares

Eliminación de una plantilla de huellas dactilares


Mesa 9 en la página 138 ilustra y describe la interacción entre el usuario y la interfaz de usuario
durante el borrado plantilla de huellas dactilares.

Tabla 9. DPFPEnrollmentControl interfaz de usuario del objeto: Eliminación de una plantilla de huella dactilar
Interfaz de usuario las acciones del usuario y la retroalimentación
interfaz de usuario
El elemento de manos indica que el índice de
huellas dactilares derecho está inscrito, es
decir, el dedo es de color verde.
El valor de la propiedad es EnrolledFingersMask
000000000 001000000, O 64.

Este mensaje aparece cuando el usuario hace clic en el


índice derecho huella digital (que fue previamente
inscrito).
Cuando el usuario hace clic en No, este mensaje es
despedido y se devuelve el control al elemento de
manos, que se mantiene sin cambios.
Cuando el usuario hace clic en Sí, este mensaje es
despedido y el control se devuelve al elemento de las
manos, en la que aparece el mensaje de huellas
dactilares eliminados (ver la siguiente imagen).

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 138
desarrollador
Capítulo 7: Interfaz de Eliminación de una plantilla
usuario de huellas dactilares

Tabla 9. DPFPEnrollmentControl interfaz de usuario del objeto: Eliminación de una plantilla de huella dactilar
(continuación)
Interfaz de usuario las acciones del usuario y la retroalimentación
interfaz de usuario
Esta imagen aparece cuando se dispara el evento
OnDelete del objeto DPFPEnrollmentControl y
devuelve un estado de EventHandlerStatusSuccess.
El valor de la propiedad EnrolledFingersMask se
establece ahora en 000000000 000000000, o 0.

El color verde se retira del dedo índice derecho, lo


que indica que la huella digital asociada ya no está
inscrito.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 139
desarrollador
Capítulo 7: Interfaz de DPFPVerificationControl objeto de interfaz de
usuario usuario

DPFPVerificationControl objeto de interfaz de usuario


La interfaz de usuario incluido con el objeto DPFPVerificationControl consta de un elemento. Este
elemento se utiliza para indicar el estado de conexión del lector de huellas digitales y para
proporcionar información sobre el proceso de verificación de huellas dactilares.Mesa 10 ilustra y
describe la interacción entre el usuario y la interfaz de usuario.

Mesa 10.DPFPVerificationControl interfaz de usuario objeto


Interfaz gráfica del usuario las acciones del usuario y la retroalimentación interfaz de usuario

Indica que el lector de huellas digitales está conectado y listo para que el
usuario escanear un dedo.

Indica que el lector de huellas digitales está desconectado.

Indica una decisión comparación de partido de una operación de


verificación de huellas dactilares.
Esta imagen aparece cuando se dispara el evento OnComplete
del objeto DPFPVerificationControl y devuelve un estado de
EventHandlerStatusSuccess, y el valor de la propiedad del objeto
verificado DPFPVerificationResult es cierto.

Indica una decisión comparación de no coincidencia de una operación de


verificación de huellas dactilares.
Esta imagen aparece cuando se dispara el evento OnComplete
del objeto DPFPVerificationControl y devuelve un estado de
EventHandlerStatusSuccess, y el valor de la propiedad del objeto
verificado DPFPVerificationResult es falsa.

Indica que la operación de captura de huellas dactilares de la muestra falló.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 140
desarrollador
El desarrollo de aplicaciones de 8
Citrix-aware
Este SDK incluye soporte para la autenticación de huellas digitales a través de Windows Terminal
Services (incluyendo la conexión de escritorio remoto) ya través de una conexión de Citrix a
MetaFrame Presentation Server utilizando un cliente del paquete del cliente de Citrix Presentation
Server.

Los siguientes tipos de clientes de Citrix son compatibles con la autenticación de huellas digitales:

 Entorno de programas
 Agente de Program Neighborhood
 Web Cliente
A fin de utilizar este apoyo, su aplicación (o el usuario final) tendrán que copiar un archivo en el equipo
cliente y registrarlo. El nombre del archivo es DPICACnt.dll, y se encuentra en la carpeta "misc \
asistencia de Citrix" en el paquete del producto.

Para implementar la biblioteca DigitalPersona para el soporte de Citrix:

1. Busque el archivo DPICACnt.dll en la carpeta "misc \ asistencia de Citrix" dentro del paquete del producto de
software.
2. Copiar el archivo a la carpeta en el equipo cliente donde se encuentran los componentes de
cliente de Citrix (es decir, para el cliente de Entorno de Programas puede ser que sea la carpeta
"Archivos de programa \ Citrix \ ICA Client").
3. Usando el programa regsvr32.exe, registrar la biblioteca DPICACnt.dll.
Si tiene varios clientes de Citrix instalados en un ordenador, implementar la biblioteca DPICACnt.dll
a la carpeta de cliente de Citrix para cada cliente.

Si su aplicación también estará trabajando con Pro Workstation 4.2.0 o Pro Kiosk 4.2.0 y posteriores,
senecesitará informar al administrador del usuario final que van a necesitar para permitir que dos
objetos de directiva de grupo (GPO), "Uso de DigitalPersona Pro Server para la autenticación" y
"Permitir redirección de datos de huellas dactilares". Para obtener información sobre cómo activar
estas políticas, consulte la "DigitalPersona Pro para Guide.pdf AD" que se encuentra en el paquete de
producto de software DigitalPersona Pro Server.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 141
desarrollador
Redistribució 9
n
YUNED puede redistribuir los archivos de la RTE \ instalar y las carpetas REDIST en el One Touch
para el paquete de software de Windows SDK para sus usuarios finales conforme a los términos del
acuerdo de licencia de usuario final (EULA), asistente del software y ubicados en la carpeta Docs en el
paquete de software SDK.

Cuando se desarrolla un producto basado en el One Touch para Windows SDK, es necesario
proporcionar los redistributables a sus usuarios finales. Estos archivos están diseñados y autorizados
para su uso con la aplicación. Puedes incluye los archivos de instalación ubicados en la RTE \ carpeta
de instalación de la aplicación, o puede incorporar las redistributables directamente en su instalador.
También puede utilizar los módulos de combinación ubicados en la carpeta Redist en el paquete de
software SDK para crear su propio instalador MSI.

Por los términos del EULA, DigitalPersona le concede una licencia no exclusiva, no transferible, a nivel
mundial redistribuyen, ya sea directamente oa través de los respectivos módulos de combinación, los
siguientes archivos contenidos en la RTE \ Instalar y carpetas REDIST en el One Touch para el
paquete de software de Windows SDK para sus usuarios finales y para incorporar estos archivos en
trabajos derivados a la venta y distribución:

RTE \ carpeta de instalación


 InstallOnly.bat
 setup.exe
 setup.msi
 UninstallOnly.bat

carpeta Redist
La siguiente tabla indica qué módulos de combinación según sea necesario para cada idioma y el
desarrollo del sistema operativo.

módulo de combinación C/C COM / ActiveX .RED Java


++
32-bit 64-bit 32-bit 64-bit 32-bit 64-bit 32-bit 64-bit

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

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 142
desarrollador
Redistribució 9
n
DpProCore_x64.msm X X X X

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 143
desarrollador
Capítulo 9: carpeta
Redistribución Redist

módulo de combinación C/C COM / ActiveX .RED 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 por orden alfabético.

 DpCore.msm
Este módulo de mezcla contiene los siguientes archivos:
 Dpcoper2.dll
 Dpdevice2.dll
 Dpfpapi.dll
 Dphostw.exe
 Dpmux.dll
 Dpmsg.dll
 Dpclback.dll
 DPCrStor.dll

 DpCore_x64.msm
Este módulo de mezcla contiene los siguientes archivos:
 Dpcoper2.dll
 Dpdevice2.dll
 Dpfpapi.dll
 Dphostw.exe

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 144
desarrollador
Capítulo 9: carpeta
Redistribución Redist

 Dpmux.dll
 Dpclback.dll
 DPCrStor.dll
 x64 \ Dpmsg.dll

 DpDrivers.msm
Este módulo de mezcla contiene los siguientes archivos:
 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
Este módulo de mezcla contiene los siguientes archivos:
 Dphftrex.dll
 Dphmatch.dll

 DpFpRec_x64.msm
Este módulo de mezcla contiene los siguientes archivos:
 <Sistema de carpetas>\ Dphftrex.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 145
desarrollador
Capítulo 9: carpeta
Redistribución Redist

 <Sistema de carpetas>\ Dphmatch.dll


 <Carpeta System64>\ Dphftrex.dll
 <Carpeta System64>\ Dphmatch.dll

 DPFpUI.msm
Este módulo de fusión contiene el archivo siguiente:
 Dpfpui.dll

 DPFpUI_x64.msm
Este módulo de fusión contiene el archivo siguiente:
 <Sistema de carpetas>\ Dpfpui.dll
 <Carpeta System64>\ Dpfpui.dll

 DpProCore.msm
Este módulo de mezcla contiene los siguientes archivos:
 Dpdevts.dll
 Dpsvinfo2.dll
 Dptsclnt.dll

 DpOTCOMActX.msm
Este módulo de mezcla contiene los siguientes archivos:
 DPFPShrX.dll
 DPFPDevX.dll
 DPFPEngX.dll
 DPFPCtlX.dll
 DpOTCOMActX_x64.msm
Este módulo de mezcla contiene los siguientes archivos:
 DPFPShrX.dll
 DPFPDevX.dll
 DPFPEngX.dll
 DPFPCtlX.dll
 x64 \ DpFpCtlX.dll
 x64 \ DpFpDevX.dll
 x64 \ DpFpEngX.dll
 x64 \ DpFpShrX.dll

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 146
desarrollador
Capítulo 9: Documentación lector de huellas
Redistribución digitales

 DpOTDotNET.msm
Este módulo de mezcla contiene los siguientes archivos:
 DPFPDevNET.dll
 DPFPEngNET.dll
 DPFPVerNET.dll
 DPFPGuiNET.dll
 DPFPCtlXTypeLibNET.dll
 DPFPCtlXWrapperNET.dll
 DPFPShrXTypeLibNET.dll
 DpOTShrDotNET.msm
Este módulo de mezcla contiene los siguientes archivos:
 DPFPShrNET.dll

Documentación lector de huellas digitales


Tú puede redistribuir la documentación que se incluye en la carpeta Redist en el One Touch para el
paquete de software de Windows SDK a los usuarios finales de conformidad con los términos de
esta sección y del EULA, asistente al software y se encuentra en la carpeta Docs en el paquete de
software SDK.

Advertencias de hardware e Información Regulatoria


Si distribuye lectores de huellas digitales Digital Persona U.are.U a sus usuarios finales, usted es
responsable de comunicándoles las advertencias e información sobre normativas incluidas en los
Avisos y archivo Information.pdf Reguladora de la carpeta Redist en el One Touch para el software de
Windows SDK paquete. Usted puede copiar y redistribuir el lenguaje, incluyendo los derechos de autor
y marcas de avisos, establecidos en los Avisos y archivo Information.pdf Regulador.

Lector de huellas dactilares de Uso y Mantenimiento


El uso lector de huellas digitales y mantenimiento guías DigitalPersona U.are.U de DigitalPersona, lector de
Mantenimiento Touch.pdf y DigitalPersona lector de Mantenimiento Swipe.pdf, se encuentran en la carpeta
Redist en el One Touch para el paquete de software de Windows SDK. Usted puede copiar y redistribuir el
DigitalPersona lector de Mantenimiento Touch.pdf y los archivos de DigitalPersona lector de Mantenimiento
Swipe.pdf, incluyendo los derechos de autor y marcas registradasavisos, a los que compran un módulo
de huellas dactilares U.are.U o un lector de usted.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 147
desarrollador
Ajuste de la Falsa Aceptación Tarifa
U
Este apéndice es para los desarrolladores que deseen especificar una tasa de aceptar falsas (FAR)
que no sea el predeterminado utilizado por el motor de reconocimiento de huellas digitales
DigitalPersona.

Tasa de Falsa Aceptación (FAR)


La tasa de aceptar falsas (FAR), también conocido como el nivel de seguridad, es la proporción de las
operaciones de verificación de huellas dactilares por los usuarios autorizados que devuelve
incorrectamente una decisión comparación de partido. El FAR se indica normalmente como la relación
entre el número esperado de aceptar falsos errores dividido por el número total de intentos de
verificación, o la probabilidad de que un sistema biométrico será falsamente aceptar un usuario no
autorizado. Por ejemplo, una probabilidad de 0.001 (o 0,1%) significa que de 1.000 operaciones de
verificación realizada por usuarios autorizados, se espera que un sistema para volver 1 decisión
partido incorrecta. El aumento de la probabilidad de, por ejemplo, 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 sobre la tasa de rechazar falso (FRR), es decir, la
disminución de la tasa de falsos acepta 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 una zona de seguridad,
pero puede no ser aceptable para un sistema donde la comodidad o fácil acceso es más importante
que la seguridad.

Representación de la Probabilidad
El motor de reconocimiento de huellas digitales DigitalPersona es compatible con la representación de la
probabilidad de que las FAR cumple plenamente las BioAPI 1,1, BioAPI 2,0, y las especificaciones
estándar UPOS. En esta representación, la probabilidad se representa como un número entero
positivo de 32 bits, o cero. (Los valores negativos se reservan para usos especiales.)

El PROBABILITY_ONE definición proporciona una forma cómoda de utilizar esta representación.


PROBABILITY_ONEtiene el valor 0x7FFFFFFF (donde el prefijo 0x indica la 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 * PROBABILITY_ONE

INT_N
P=
PROBABILITY_ONE

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 de la tercera fila representa el
valor predeterminado actual utilizada por la DigitalPersona Fingerprint Recognition Engine, que ofrece
un mediados -range nivel de seguridad. El valor de la segunda fila representa un nivel de seguridad
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 148
desarrollador
FAR / bajo de la alta típico, y el valor en la cuarta fila representa un nivel típico de baja FAR / alta
seguridad.
El valor resultante de INT_N está representado en la columna dos, en notación decimal.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 149
desarrollador
Apéndice A: Ajuste de la velocidad
Aceptar Falso

Tabla 2. Los valores comunes de la 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

solicitada FAR
Tú especificar el valor de la FAR, que se INT_N partir de la ecuación anterior, utilizando el
FARRequested propiedad (VB página 63, C ++ página 115). Si bien se puede solicitar cualquier valor entre
0 y el valor PROBABILITY_ONE, seNo se garantiza que el motor cumplirá la solicitud exactamente. La
aplicación del motor hace el mejor esfuerzo para dar cabida a la solicitud fijando internamente el valor
más cercano a la solicitada dentro de las restricciones que impone la seguridad.

Especificación de las FAR en Visual Basic


Si está desarrollando su aplicación en Visual Basic, se especifica el valor de las FAR (INT_N) en el
parámetro lValue en la propiedad del objeto FARRequested DPFPVerification. El siguiente ejemplo
de código establece el FAR a un valor de 0,0001, o 0.01%.

Const PROBABILITY_ONE tan largo = & H7FFFFFFF

verificación Dim como nuevo DPFPVerification ()


...

'Establece la FAR a 0,01%


verification.FARRequested = PROBABILITY_ONE / 10000

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 150
desarrollador
Apéndice A: Ajuste de la velocidad
Aceptar Falso

Especificación de la FAR en C ++
Si está desarrollando su aplicación en C ++, se especifica el valor de las FAR (INT_N) en el parámetro
pVal del IDPFPVerification :: propiedad FARRequested. El siguiente ejemplo de código establece el
FAR a un valor de 0,000001, o 0,0001%.

#define PROBABILITY_ONE (0x7FFFFFFF)

IDPFPVerification * verificación;
...

// Establece la FAR a 0,0001%


rc = verificación -> put_FARRequested (PROBABILITY_ONE / 1000000);

Conseguido FAR
El valor real de la logrado FAR para una operación de verificación particular, se devuelve en el
parámetro lValue de la propiedad FARAchieved del objeto DPFPVerificationResult en Visual Basic
(página 67) O en el parámetro pVal de IDPFPVerificationResult :: propiedad FARAchieved en C ++
(página 121).
Este valor es normalmente mucho menor que las FAR solicitada debido a la precisión de la
DigitalPersona Fingerprint Recognition Engine. Las FAR solicitado especifica el valor máximo de las
FAR a ser utilizado por el motor en la toma de la decisión de verificación. Las FAR real alcanzada por
el motor cuando se realiza una comparación legítima es por lo general un valor mucho más bajo. La
aplicación del motor puede elegir el rango y granularidad para el logrado FAR. Si usted hace uso de
este valor en su aplicación, por ejemplo, mediante la combinación con otros FAR alcanzados, que
debe administrarse con precaución, ya que la granularidad y el rango puede variar entre versiones de
SDK DigitalPersona sin previo aviso.

Pruebas
Aunque es posible alcanzar los valores deseados de las FAR en su entorno de desarrollo, no se
garantiza que la aplicación va a alcanzar el nivel de seguridad requerido en situaciones del mundo
real. A pesar de que el motor está diseñado para hacer su mejor esfuerzo para aplicar con precisión
las estimaciones de probabilidad, se recomienda que lleve a cabo las pruebas de nivel de sistema
para determinar el punto de funcionamiento real y la precisión en un escenario dado. Esto es aún más
importante en los sistemas donde se utilizan múltiples factores biométricos para la identificación.

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 151
desarrollador
Plantilla de inscripción SDK Platinum Conversión
se
Este apéndice es para los usuarios que necesitan Platinum SDK para convertir sus plantillas de
registro Platinum SDK a un formato que es compatible con los SDK que se enumeran en
Compatibilidad plantilla de huellas dactilares en la página 5.

código de ejemplo se incluye a continuación para C ++ y Visual Basic.

Platinum SDK de inscripción de conversión de plantilla para Microsoft Visual


C ++
Utilizar Código de ejemplo 1 en aplicaciones desarrolladas en Microsoft Visual C ++ para convertir
DigitalPersona Platinum SDK las plantillas de registro.

Ejemplo de código 1. Platinum SDK de conversión de plantilla para Microsoft Visual C ++ Aplicaciones
import "DpSdkEng.tlb" no_namespace, named_guids, raw_interfaces_only #
include <atlbase.h>

bool PlatinumTOGold (sin firmar char * platinumBlob, int


platinumBlobSize, unsigned char * goldBlob, int
goldBufferSize,
int * goldTemplateSize)
{
// Cargar la matriz de bytes en FPTemplate Object
// para crear Platinum rgsabound
plantilla de objeto SAFEARRAYBOUND;
rgsabound.lLbound = 0;
rgsabound.cElements = platinumBlobSize;

CComVariant varVal;
varVal.vt = VT_ARRAY | VT_UI1;
varVal.parray = SafeArrayCreate (VT_UI1, 1, y rgsabound);

datos sin firmar char *;


si (falló (SafeArrayAccessData (varVal.parray, (void **) y datos)))
return false;

memcpy (datos, platinumBlob, platinumBlobSize); SafeArrayUnaccessData


(varVal.parray);

IFPTemplatePtr pIFPTemplate (uuidof (FPTemplate));

si (pIFPTemplate == NULL)
falso retorno;

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 150
desarrollador
Apéndice B: Conversión de platino plantilla de inscripción
SDK

Ejemplo de código 1. Platinum SDK de conversión de plantilla para Microsoft Visual C ++ Aplicaciones
AIErrors error;
si (FALLO (pIFPTemplate-> Importar (varVal, y
error))) return false;

si (error = Er_OK!)
return false;

// Ahora pIFPTemplate contiene la plantilla de platino.


// Usar la propiedad TemplData para obtener la plantilla
de Oro a cabo. CComVariant varValGold;

si (FALLO (pIFPTemplate-> get_TemplData (y varValGold)))


return false;

unsigned char * dataGold;


si (falló (SafeArrayAccessData (varValGold.parray, (void **) y dataGold)))
return false;

int = blobSizeRequired varValGold.parray->> rgsabound- Celements


*
varValGold.parray-> cbElements;
* GoldTemplateSize =
blobSizeRequired;

si (goldBufferSize <blobSizeRequired)
{SafeArrayUnaccessData
(varValGold.parray); falso retorno;
}

memcpy (goldBlob, dataGold, blobSizeRequired);

SafeArrayUnaccessData (varValGold.parray);

return true;

(continuación)

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 151
desarrollador
Apéndice B: Conversión de platino plantilla de inscripción
SDK

Platinum SDK de inscripción Conversión plantilla para Visual Basic 6.0


Utilizar Código de ejemplo 2 en aplicaciones desarrolladas en Microsoft Visual Basic 6.0 para convertir
DigitalPersona Platinum plantillas de inscripción SDK.

Código de ejemplo 2. Platinum SDK de conversión plantilla para Visual Basic 6.0
Función pública PlatinumToGold (platinumTemplate como variante) As Byte
() Dim pTemplate Como Nueva FPTemplate
Dim vGold Como
Variant Dim bGold ()
As Byte

er tenue Como DpSdkEngLib.AIErrors


er = pTemplate.Import (platinumTemplate)
Si er <> Er_OK Entonces PlatinumToGold = "": Salir la
función vGold = pTemplate.TemplData
bGold = vGold
PlatinumToGold = bGold
End Function

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 152
desarrollador
Glosario

en el que se devuelve una decisión incorrecta del partido.


sistema biométrico
tasa de rechazo falso (FRR)
Un método automático de identificación de
una persona basándose en los rasgos La proporción de las transacciones de verificación de huellas
físicos y / o de comportamiento únicas de dactilares por los sujetos registro de huellas dactilares
la persona, como una huella digital o un
patrón del iris, o una firma manuscrita o
una voz.

comparación
La estimación, cálculo o medición de similitud
o disimilitud entre conjunto (s) característica
de huellas dactilares y la plantilla (s) de
huellas dactilares.

puntuación de comparación
El valor numérico que resulta de una comparación
de conjunto (s) característica de huellas
dactilares con la plantilla (s) de huellas
dactilares. las puntuaciones de la comparación
pueden ser de dos tipos: puntuaciones de
similitud o las puntuaciones de disimilitud.

contexto
Un objeto temporal que se utiliza para pasar
datos entre las etapas de las operaciones de
programación de múltiples pasos.

Motor DigitalPersona Fingerprint Recognition


Un conjunto de algoritmos matemáticos
formales para determinar si un conjunto de
características de huellas digitales coincide
con una plantilla de huellas dactilares de
acuerdo con un nivel de seguridad
especificado en términos de la tasa de falsos
aceptar (FAR).

inscrita
Ver Datos sujetos de huellas dactilares.

inscripción
Ver registro de huellas dactilares.

tasa de aceptar falsas (FAR)


La proporción de transacciones de verificación
de huellas dactilares por los afectados de
huellas digitales no está inscrito en el sistema
DigitalPersona One Touch para Windows SDK: C / C ++ Edición | Guía del 153
desarrollador
de huellas dactilares para la referencia. Cada
en contra de su propia plantilla plantilla de huella digital se asocia con un
(s) de huellas digitales, donde sujeto registro de huellas dactilares.
se devuelve una decisión Plantillas de huellas dactilares pueden ser
incorrecta de no coincidencia. almacenados dentro de un dispositivo de captura
de huellas dactilares; en un medio portátil como
caracteristicas una tarjeta inteligente; a nivel local, como en un
Ver características de huellas digitales. ordenador personal o un servidor local; o en una
base de datos central.
huella dactilar
Una impresión de las crestas en la piel de un Datos sujetos huella digital
dedo. Una persona cuya muestra (s) de huellas
dactilares, sistema (s) característica de huellas
dispositivo de captura de huellas dactilares digitales, o plantilla (s) de huellas dactilares están
Un dispositivo que recoge una presentes dentro del sistema de reconocimiento
señal de características de huellas de huellas digitales en cualquier momento.
digitales un datos del sujeto huella
digital y la convierte en una muestra
de la huella digital. Un dispositivo
puede ser cualquier pieza de
hardware (y software de soporte y
firmware). En algunos sistemas, la
conversión de una señal a partir de
características de huellas digitales
para una muestra de la huella
digital puede incluir múltiples
componentes, tales como una
cámara, papel fotográfico,
impresora, escáner digital o la tinta
y el papel.

característica de huellas dactilares


Biológicos detalles de la
superficie del dedo que pueden
ser detectados y de la que el
conjunto de características de
huellas digitales distintiva y
repetible (s) se pueden extraer
con el propósito de verificación de
huellas dactilares o registro de
huellas dactilares.

de datos de huellas dactilares


O bien el conjunto de
características de huellas
digitales, la plantilla de huella
digital, o la muestra de la
huella digital.

subsistema de almacenamiento de datos de


huellas dactilares
Un medio de almacenamiento
DigitalPersona One Touch para Windows SDK: C / C ++ Edición | Guía del 154
donde se almacenan plantillas
desarrollador
Glosario

datos de huellas digitales puede ser o bien de imagen de la huella


una persona que está siendo reconocido o de
un sujeto registro de huellas dactilares. Una representación digital de la huella digital dispone antes
de la extracción que se obtiene de un lector de huellas
registro de huellas dactilares digitales. Véase también la muestra de la huella digital.
a. En un sistema de reconocimiento de huellas
dactilares, el proceso inicial de la recogida de
datos de huellas dactilares de una persona
mediante la extracción de las características de
huellas digitales de imagen de la huella de la
persona con el propósito de la inscripción y a
continuación almacenar los datos resultantes
en una plantilla para la comparación posterior.
b. La función del sistema que calcula una
plantilla de huella digital a partir de un conjunto
(s) característica de huellas dactilares.

sujeto registro de huellas dactilares


El sujeto de los datos de huellas dactilares
cuya huella digital plantilla (s) se llevan a cabo
en el subsistema de almacenamiento de datos
de huellas digitales.

extracción de características de huellas


digitales
La función del sistema que se aplica a una
muestra de la huella digital para calcular
información repetible y distintivo que se utiliza
para la verificación de huellas dactilares o
registro de huellas dactilares. La salida de la
función de extracción de características de
huellas digitales es un conjunto de
características de huellas digitales.

características de huellas dactilares


Las características distintivas y persistentes de
las crestas en la piel de un dedo. Ver también
las características de huellas dactilares.

conjunto de características de huellas


digitales
La salida de un proceso de extracción de
características de huellas digitales completado
aplicó a una muestra de huella digital. Un
conjunto (s) característica de huellas digitales
puede ser producido con el propósito de
verificación de huellas dactilares o con el
propósito de registro de huellas dactilares.

DigitalPersona One Touch para Windows SDK: C / C ++ Edición | Guía del 155
desarrollador
Glosario
Lector de huellas dactilares partido o no partido.
Un dispositivo que recoge datos de partido
características de huellas dactilares
La decisión de que el conjunto (s) característica
de una persona y la convierte en
de huellas dactilares y la plantilla (s) de huellas
una imagen de huella dactilar para.
dactilares se comparan son del mismo sujeto de
sistema de reconocimiento de huellas los datos de huellas dactilares.
dactilares
no coincidencia
Un sistema biométrico que utiliza
La decisión de que el conjunto (s) característica
las características distintivas y
de huellas dactilares y la plantilla (s) de huellas
persistentes de las crestas de un
dactilares que se comparan no son del mismo
dedo, también se conoce como
sujeto de los datos de huellas dactilares.
características de huellas
dactilares, para distinguir un dedo
(o persona) de otro.

muestra de la huella digital


El análogo o representación digital
de las características de las huellas
dactilares antes de la extracción de
características de huellas digitales
que se obtienen de un dispositivo de
captura de huellas dactilares. Una
muestra de la huella digital puede
ser cruda (como capturado) o
intermedia (después de algún
procesamiento).

plantilla de huellas dactilares


La salida de un proceso de registro
de huellas dactilares completado
que se almacena en un subsistema
de almacenamiento de datos de
huellas digitales. Plantillas de
huellas dactilares se almacenan
para su posterior comparación con
un conjunto (s) característica de
huellas dactilares.

verificación de huellas dactilares


a. En un sistema de reconocimiento
de huellas dactilares, el proceso de
extracción de las características de
huellas dactilares imagen de la
huella de una persona desde
proporcionados con el propósito de
verificación, la comparación de los
datos resultantes de la plantilla que
se genera durante la inscripción, y
decidir si ambas coinciden.
b. La función del sistema que
DigitalPersona
realiza unaOne Touch para Windows
comparación SDK: C / C ++ Edición | Guía del
de uno-a- 156
desarrollador
uno y toma una decisión de
Glosario

uno-a-uno la comparación
El proceso en el que conjunto (s) característica
de reconocimiento de la huella digital de uno o
más dedos de sujeto de los datos una huella
digital se compara con la plantilla (s) de huellas
dactilares a partir de uno o más dedos de
sujeto de los datos una huella digital.

repositorio
Ver subsistema de almacenamiento de datos de huellas digitales.

nivel de seguridad
El falso objetivo acepta tarifa para una
comparación contexto. Ver también FAR.

verificación
Ver verificación de huellas dactilares.

DigitalPersona One Touch para Windows SDK: C / C ++ Edición | Guía del 157
desarrollador
Índice

definido
símbolos
interfaz _IDPFPCaptureEvents, definido 81
_IDPFPEnrollmentControlEvents

Incluso OnCancelEnroll 91
OnComplete Evento 91
OnDelete Evento 92
OnEnroll Evento 93
OnFingerTouch Evento 94
interfaz _IDPFPEnrollmentControlEvents, definido 91
interfaz _IDPFPVerificationControlEvents, definido 120
_NewEnum propiedad,
definido C ++ 107
visual Basic 59
UNA
propiedad Active
define
DPFPVerificationControl
visual Basic 64
método addFeatures
llamando en el flujo de trabajo típico de registro
de huellas dactilares 22
definido
C ++ 85
visual Basic 41
Recursos adicionales 4
recursos en línea 4
documentación relacionada 4
Permitir redirección de datos de huellas dactilares
141
C referencia API
++ 76-130
visual Basic 34-75
público de esta guía 2
segundo
sistema
biométrico
definido 153
explicado 17
negrita, utiliza de 3
do
capítulos, descripción de 2
Citrix 1
Cliente Web de Citrix 1
Citrix, para el desarrollo 141
método Clear
llamando en el flujo de trabajo típico de registro
de huellas dactilares 23
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 156
desarrollador
Visual Basic 53 DPFPSample objeto de
C ++ 85 Visual Basic 60 DPFPTemplate objeto
visual Basic 41 de Visual Basic 62 interfaz IDPFPData
comparación, definido 153 para C ++ 83 interfaz
plantillas de huellas digitales compatibles IDPFPFeatureSet para C ++ 99
Ver objetos componentes de interfaz IDPFPSample para C ++ 109
compatibilidad plantilla de huellas interfaz IDPFPTemplate para C ++ 113
dactilares (Visual Basic) 34-67
Ver también componentes
individuales objetos por nombre
contexto
definido 153
convenciones, documento
Ver convenciones del documento
la conversión de plantillas de
inscripción Platinum SDK para
Microsoft Visual Basic 6.0
152
para Microsoft Visual C ++ 150
método
ConvertToANSI381,
definido C ++ 111
visual Basic 61
método
ConvertToPicture,
definido C ++ 111
visual Basic 61
Contar los
bienes,
definidos
C ++ 106
visual Basic 58
Courier negrita, el uso de 3
método
CreateFeat
ureSet
vocación
en flujo de trabajo típico registro de huellas
dactilares 22
en flujo de trabajo típico verificación de huellas
dactilares 28
definido
C ++ 97
visual Basic 52
re
la supresión de una huella digital
Ver anulado el
registro de un
método de
huella digital
Deserialize
llamando en huellas dactilares
objeto de datos de flujo de
trabajo deserialización 33
definido
DPFPData objeto de
DigitalPersona 40 para Windows SDK: COM / ActiveX Edición | Guía del
One Touch
Visual Basic 157
desarrollador
DPFPFeatureSet objeto de
Índic r
e e

deserializar huella digital de flujo de trabajo visual Basic 71


objeto de datos 33 Motor DigitalPersona DPFPFeatureExtraction objeto de Visual Basic, definido 51
Fingerprint Recognition 17 productos objeto DPFPFeatureExtraction, creando
DigitalPersona, apoyados 5 en flujo de trabajo típico registro de huellas dactilares 22
convenciones del documento 3 en flujo de trabajo típico verificación de huellas dactilares 28
documentación, relacionada 4 objeto DPFPFeatureSet la creación
DPFPCapture objeto de Visual Basic
36 objeto DPFPCapture, creando
en flujo de trabajo típico registro de
huellas dactilares 22
en flujo de trabajo típico verificación de
huellas dactilares 28 DPFPCaptureEvents
controlador de eventos, la aplicación de en flujo
de trabajo típico registro de huellas dactilares
22
en flujo de trabajo típico verificación de
huellas dactilares 28
DPFPCaptureFeedbackEnum, definido
C ++ 124
visual Basic 69
DPFPCapturePriorityEnum, definido
C ++ 125
visual Basic 70
DPFPData objeto de Visual Basic, que se define
40
DPFPDataPurposeEnum, definido C
++ 127
visual Basic 72
DPFPEnrollment objeto de Visual Basic, que se
define 41
objeto DPFPEnrollment, creando, en la huella digital
típico flujo de trabajo de inscripción 22
DPFPEnrollmentControl objeto de Visual
Basic, definido 43
DPFPEnrollmentControl objeto, creando
en el registro de huella típica con el flujo de
trabajo de soporte UI 24
en el típico plantilla supresión de huellas
dactilares con el flujo de trabajo de
soporte UI 26
DPFPEnrollmentControlEvents controlador de
eventos, implementación típica de la
matrícula de huellas dactilares con el flujo
de trabajo de soporte de interfaz de usuario
24
DPFPEnrollmentControlEvents controlador de
eventos, la aplicación de, en el típico
eliminación plantilla de huellas dactilares
con el flujo de trabajo de soporte UI 26
DPFPEventHandlerStatus objeto de Visual Basic,
definido 51
DPFPEventHandlerStatusEnum, definido C
++ 126
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 158
desarrollador
Índic r
e en flujo de trabajo típico registro de huellas DPFPVerification objeto de Visual Basic, que se define e
63
dactilares 22 objeto DPFPVerification, creando
en la verificación de huellas dactilares típico
en flujo de trabajo típico verificación de
huellas dactilares 28 con el flujo de trabajo de soporte UI 31
recibir, en flujo de trabajo en flujo de trabajo típico verificación de huellas dactilares 28
típico verificación de DPFPVerificationControl objeto de Visual
huellas dactilares 31 Basic, definido 64
DPFPFeatureSet objeto de Visual Basic, que se DPFPVerificationControl objeto, creando, en la
define 53 verificación de huellas dactilares típico con el
DPFPReaderDescription objeto de flujo de trabajo de soporte UI 31
Visual Basic, definido 54 DPFPVerificationControlEvents controlador de eventos,
DPFPReaderImpressionTypeE
num, definido C ++ 128
visual Basic 73
DPFPReadersCollection objeto
de Visual Basic, definido
58
DPFPReaderTechnologyEn
um, definido C ++ 128
visual Basic 73
DPFPSample objeto de Visual Basic, que se
define 60
DPFPSampleConversion objeto de
Visual Basic, definido 61
DPFPSerialNumberTypeEn
um, definido C ++ 129
visual Basic 74
objeto
DPFPTem
plate la
creación
a partir de datos serializados
en la verificación de huellas
dactilares típico con el
flujo de trabajo de soporte
UI 31
en flujo de trabajo típico verificación de
huellas dactilares 28
en flujo de trabajo típico registro de huellas
dactilares 22
serialización
en el registro de huella típica
con el flujo de trabajo de
soporte UI 25
en flujo de trabajo típico registro de huellas
dactilares 22
almacenar
en el registro de huella típica
con el flujo de trabajo de
soporte UI 25
en flujo de trabajo típico
registro de huellas dactilares 22
DPFPTemplate objeto de Visual
Basic, que se define 62
DPFPTemplateStatusEnum,
definido
C ++ 130 One Touch para Windows SDK: COM / ActiveX Edición | Guía del
DigitalPersona 159
desarrollador
visual Basic 75
Índic m
e i

la implementación, en la verificación de LEJOS


huellas dactilares con el flujo de trabajo SEmi falsa tasa de aceptar la propiedad
típico de soporte de interfaz de usuario 31 FARAchieved
DPFPVerificationResult objeto de Visual Basic, que se definido
define 67 C ++ 121
DPFPVerificationResult objeto, recibiendo
en la verificación de huellas dactilares típico
con el flujo de trabajo de soporte UI 31
en flujo de trabajo típico verificación de huellas
dactilares 29
mi
Motor
Ver Motor DigitalPersona Fingerprint Recognition
propiedad EnrolledFingersMask
definido
C ++ 87
visual Basic 43
ajuste
en el registro de huella típica con el flujo de
trabajo de soporte UI 24
en el típico plantilla supresión de huellas
dactilares con el flujo de trabajo de
soporte UI 26
inscrita 18
inscribir una huella digital 24
inscripción
Ver máscara inscripción registro
de huellas dactilares, valores
posibles para
C ++ 88
visual Basic 44, 88
enumeraciones
C ++ 123-130
Ver también tipos enumerados individuales
por nombre de Visual Basic 68-75
Ver también enumeraciones individuales por su
nombre
F
tasa de aceptar la falsa 19
definido 153
establecer a valor distinto del predeterminado 147
falsa decisión negativa 19
falsa decisión negativa, la proporción
de 19 Ver también tasa de aceptar
la falsa
decisión falso positivo 19
la decisión de falsos positivos, la
proporción de 19 Ver también tasa
de aceptar la falsa
falsos positivos y falsos negativos 19
falsa tasa de rechazo 19
definido 153
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 160
desarrollador
Índic m
e visual
definido 153 i
Basic Ver Lector de huellas dactilares
67 características de huellas digitales, definidas 153
explic de datos de huellas dactilares 18
definido 153
ación
de 149 objeto de datos de huellas dactilares 40, 83
propiedad recuperar datos serializados de almacenamiento 33
FARReque serialización / deserialización flujo de trabajo 32
sted almacenar datos serializados, en la huella
definido digital objeto de datos de flujo de
C ++ 115 trabajo de serialización 32
visual Basic 63 subsistema de almacenamiento de datos de huellas dactilares,
aviso importante para leer el que se define 153
Apéndice A antes de 63, supresión de huellas digitales
115 Ver registro de huellas dactilares
ajuste unenrollment huella digital 18
en la verificación típico con el flujo de trabajo de definido 154
soporte UI 31 con flujos de trabajo de apoyo a la interfaz de usuario 23
en el flujo de trabajo típico de verificación 28 flujo de trabajo 20
que no sea el predeterminado 148 extracción de características de huellas digitales
caracteristicas
Ver
Característic
as de la
propiedad de
huellas
digitales
FeatureSet
definido
C ++ 97
visual Basic 52
FeaturesNeeded
propiedad, definido C
++ 85
visual Basic 41
archiv
os y
car
pet
as
inst
alad
o
par
a
RT
E
la instalación de 32 bits 14
instalación de 64 bits 15
instalada para SDK 13
dedo índice, valores posibles para 46, 92
huella dactilar 17
definido 153
flujo de trabajo para inscribirse con el apoyo de IU
24
flujo de trabajo para anulado el registro (borrado)
con el apoyo
DigitalPersona UI 25para Windows SDK: COM / ActiveX Edición | Guía del
One Touch 161
desarrollador
dispositivo de captura de huellas dactilares 18
Índic s
e ol

definido 154 dactilares 5 unenrollment de huellas digitales, el


conjunto de características de huellas digitales 18 flujo de trabajo 25 verificación de huellas
definido 154 dactilares 18
Ver también objeto definido 154
DPFPFeatureSet características verificación de huellas dactilares con el flujo de trabajo de
de huellas digitales, definidas soporte UI 29 flujo de trabajo de verificación de huellas
154 huella digital de la imagen, dactilares 26 propiedad FirmwareRevision
se define 154 Lector de huellas
dactilares 18
definido 154
la redistribución de la documentación para 146
usar y guías de mantenimiento, redistribuyendo
146
reconocimiento de huellas dactilares 18
sistema de reconocimiento de huellas dactilares 17
definido 154
Ver también sistema de reconocimiento de huellas
digitales DigitalPersona reconocimiento de huellas
dactilares, guiar a 4
muestra de la
huella digital
captura
en el registro de huella típica con el flujo de
trabajo de soporte UI 25
en flujo de trabajo típico registro de huellas
dactilares 22
en la verificación de huellas dactilares típico
con el flujo de trabajo de soporte UI 31
en flujo de trabajo típico verificación de
huellas dactilares 28 Ver también objeto
DPFPSample
muestra de la huella digital,
que se define 154 Ver
imagen de la huella
plantilla de huellas dactilares 18
crear, flujo de trabajo para con el apoyo de IU 24
definido 154
borrar de almacenamiento, en el típico huella
digital plantilla eliminación flujo de trabajo 26
recuperar datos serializados de almacenamiento
en la verificación de huellas dactilares típico
con el flujo de trabajo de soporte UI 31
en flujo de trabajo típico verificación de huellas
dactilares 28
serializar, en flujo de trabajo típico
registro de huellas dactilares 22
almacenar
en el registro de huella típica con el flujo de
trabajo de soporte UI 25
en flujo de trabajo típico registro de huellas
dactilares 22
flujo de trabajo para la inscripción 20
Ver también objeto DPFPTemplate
compatibilidad plantilla de huellas
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 162
desarrollador
Índic IDPFPReadersCollection para C ++, que se define 106s
e definido ol
C ++ 101 interfaz IDPFPSample para C ++, que se define 109
visual Basic 54 interfaz IDPFPSampleConversion para C ++, que se
define 111 interfaz IDPFPTemplate para C ++, que
carpet
se define 113 IDPFPVerification
as y
arc
hivo propiedad activo 115, 118
s interfaz IDPFPVerification para C ++, que se define
inst 115 interfaz IDPFPVerificationControl para C ++, que
alad se define 118 interfaz IDPFPVerificationResult para C
o ++, que se define 121
par
a
RT
E
la instalación de 32 bits 14
instalación de 64 bits 15
instalada para SDK 13
FRR
SEmi falsa tasa de rechazo
sol
Objetos de directiva de grupo 141
H
Advertencias de hardware e
información sobre normativas,
redistribuidor 146
propiedad
HardwareRevision
definido
C ++ 101
visual Basic 54
yo
interfaz IDPFPCapture para C ++, que
se define 78 interfaz IDPFPData para C
++, que se define 83 interfaz
IDPFPEnrollment para C ++, que se
define 85 interfaz
IDPFPEnrollmentControl para C ++, que
se define 87
IDPFPEnrollmentControlEvents

OnCancelEnroll Evento 91
OnComplete Evento 91
OnFingerRemove Evento 93
OnFingerTouch Evento 94
OnReaderConnect Evento 94
OnReaderDisconnect Evento 94
OnSampleQuality Evento 95
OnStartEnroll Evento 95
interfaz IDPFPEventHandlerStatus para C
++, que se define 96 interfaz
IDPFPFeatureExtraction para C ++, que
se define 97 interfaz IDPFPFeatureSet
para C ++, que se define 99 interfaz
IDPFPReaderDescription
DigitalPersona One Touch para para C ++,
Windows que
SDK: COM / ActiveX Edición | Guía del 163
se define 101
desarrollador interfaz
Índic L
e

imagen MetaFrame Presentation Server 1


Ver imagen de la huella norte
notación importante, definido convenciones de nombres 3
3 noticia importante no coincidencia 19
lea el Apéndice A antes de FARRequested definido 154
propiedad 63, 115 convenciones de notación 3
establecer las propiedades opcionales
para mantener la funcionalidad
aplicación coherente 34, 76
ImpressionType propiedad, definido
C ++ 102
visual Basic 55
instalación 12
archivos de instalación para redistributables,
redistribuyendo 142
la
instalació
n de
evaluació
n en
tiempo
real 13
RTE en silencio dieciséis
SDK 12
las interfaces (C ++) 76-122
Ver también interfaces individuales
de introducción a nombre de guía
para desarrolladores 1
cursiva tipo de letra, usos de 3
propiedad Item,
definida C ++ 107
visual Basic 59
L
l1FingersMask, valores posibles para en Visual
Basic 46
propiedad de idioma, que
se define C ++ 101
visual Basic 54
METRO
partido 19
definido 154
propiedad
MaxEnrollFingerCount
definido
C ++ 89
visual Basic 44
ajuste
en el registro de huella típica con el flujo de
trabajo de soporte UI 25
módulos de fusión de
contenido de 142
redistribuidor 142
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 160
desarrollador
Índic efinido L
notación
e de la nota, que se define 3
visual Basic 47
O recibir, en la plantilla típica de huellas
evento dactilares con el flujo de trabajo de
OnC soporte UI 26
ance evento OnEnroll
lEnr definido
oll visual Basic 47
defin recibir, en la plantilla típica de huellas
ido dactilares con el flujo de trabajo de
visual Basic 46 soporte UI 25
eve uno-a-uno la comparación 19
nt definido 155
o OnFingerGone evento, que se
O define C ++ 81
n visual Basic 38
C evento OnFingerRemove
o definido
m visual Basic 48
pl evento OnFingerTouch
et definido
e visual Basic 48
d OnFingerTouch evento, que se
ef define C ++ 82
in visual Basic 38
id recursos en línea 4
o evento OnReaderConnect
visual Basic 46 definido
DPFPCapt visual Basic 48
ureEven
ts
definid
o
C ++ 81
visual Basic 38
recepción
en flujo de trabajo típico registro de huellas
dactilares 22
en flujo de trabajo típico verificación de
huellas dactilares 28
DPFPVerificationCo
ntrolEvents
definido
C ++ 120
visual Basic sesenta y cinco
recibir, en la verificación de
huellas dactilares típico con
el flujo de trabajo de
soporte UI 31
even
to
O
n
D
el
et
e
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 160
d
desarrollador
Índic P
e A

OnReaderConnect evento DPFPVerificationControl


definido C ++ 82 C ++ 119
visual Basic 39 visual Basic sesenta y cinco
evento OnReaderDisconnect ajuste
definido en el registro de huella típica con el flujo de
visual Basic 49 trabajo de soporte UI 25
OnReaderDisconnect evento, que en flujo de trabajo típico registro de huellas dactilares 22
se define C ++ 82 en la verificación de huellas dactilares típico
visual Basic 39 con el flujo de trabajo de soporte UI 31
evento OnSampleQuality en flujo de trabajo típico verificación de
definido huellas dactilares 28 carpeta Redist, la
visual Basic 49, 50 redistribución de los contenidos de 142
OnSampleQuality evento, que se redistributables, redistribución 142
define C ++ 83 redistribución de archivos 142
visual Basic 39 información reglamentaria, requisito para asesorar a los
visión general usuarios finales de 146
de capítulos 2 autentificación remota 1
del SDK 17 Conexión de escritorio remoto
1 repositorio 18
PAG requisitos, el sistema de
Platinum SDK conversión plantilla inscripción 150 Ver Requisitos del sistema
propiedad de recursos, adicional
prioridad definido Ver Recursos adicionales
C ++ 78 recursos en línea,
visual Basic 36 Ver recursos en línea
ajuste RTE
en flujo de trabajo típico registro de huellas instalación 13
dactilares 22 instalar / desinstalar silenciosamente dieciséis
en flujo de trabajo típico verificación de redistribuidor 142
huellas dactilares 28 RTE \ carpeta de instalación, la redistribución de contenidos 142
la compatibilidad del producto entorno de ejecución
Ver huella digital plantilla propiedad Ver RTE
ProductName compatibilidad, definido
C ++ 102 S
visual Basic 55 código de ejemplo para la conversión de inscripción
Entorno de programas 1 Platinum SDK plantillas
Agente de Program Neighborhood 1 para Microsoft Visual Basic 6.0 152
para Microsoft Visual C ++ 150
Q SDK
de inicio rápido, introducción al SDK 6 archivos y carpetas instalado 13
R instalación 12
Método lector, que se define Inicio rápido 6
C ++ 106 nivel de seguridad 20
visual Basic 58 serializar método
propiedad ReaderSerialNumber llamando en huellas dactilares objeto de
definido datos de flujo de trabajo de
DPFPCapture C serialización 32
++ 79 DPFPData objeto de Visual Basic 40
visual Basic 37 DPFPFeatureSet objeto de Visual Basic
DPFPEnrollmentControl C 53 DPFPSample objeto de Visual
++ 89 Basic 60 DPFPTemplate objeto de
visual Basic 45 Visual Basic 62 interfaz IDPFPData
para C ++ 84

DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 161
desarrollador
Índic T
e

interfaz IDPFPFeatureSet para C ++ convenciones tipográficas 3


99 interfaz IDPFPSample para C T
++ 110 interfaz IDPFPTemplate para parámetro uFingerMask, valores posibles para en C ++ 92
C ++ 114 anulado el registro de una huella dactilar 25
serializar huella digital de flujo de trabajo objeto de desinstalación RTE en silencio dieciséis
datos 32
SerialNumber propiedad,
definido C ++ 103
visual Basic 55
SerialNumberType propiedad, definido
C ++ 103
visual Basic 56
silenciosamente instalar
RTE dieciséis método
StartCapture
vocación
en flujo de trabajo típico registro de huellas
dactilares 22
en flujo de trabajo típico verificación de
huellas dactilares 28
definido
C ++ 79
visual Basic 36
propiedad de estado,
que se define C ++
96
visual Basic 51
método StopCapture
vocación
en flujo de trabajo típico registro de huellas
dactilares 22
en flujo de trabajo típico verificación de
huellas dactilares 28
definido
C ++ 80
visual Basic 36
DigitalPersona productos compatibles 5
Requisitos del sistema 4
T
público objetivo de esta guía 2
propiedad de la tecnología,
que se define C ++ 104
visual Basic 56
la compatibilidad de plantilla
Ver huella digital plantilla propiedad Template
compatibilidad, definido
C ++ 86
visual Basic 42
TemplateStatus propiedad, definido
C ++ 86
visual Basic 42
tipografías, usos de
3
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 162
desarrollador
Índic
versiones
e de productos de software en la verificación de huellas dactilares típico T
DigitalPersona, el URL para con el flujo de trabajo de soporte UI 31
descargan 4 en flujo de trabajo típico verificación de huellas dactilares 28
URL definido
DigitalPersona Foro Developer Connection 4 C ++ 116
Las actualizaciones de software DigitalPersona visual Basic 63
Productos 4 W
usar y guías de mantenimiento de sitio web
lectores de huellas digitales, DigitalPersona Foro Developer Connection 4
redistribuidor 146 Las actualizaciones de software DigitalPersona Productos 4
Utilice DigitalPersona Pro Server para la Windows Terminal Services 1
autenticación 141 flujos de trabajo 20-33
V
propiedad
del
provee
dor,
que se
define
C ++
104
visual Basic 56
verificación
Ver verificación de
huellas dactilares
propiedad Verified,
define
C ++ 121
visual Basic 67
v
e
r
i
f
i
c
a
r

e
l

m
é
t
o
d
o

v
o
c
a
c
i
ó 163
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del
n
desarrollador

Você também pode gostar