Escolar Documentos
Profissional Documentos
Cultura Documentos
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
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........................................................................................
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
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
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
Í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.
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.
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.
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 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.
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 4
desarrollador
Capítulo 1: Convenciones del
Introducción documento
Símbolos convencionales
Las siguientes convenciones de notación se utilizan en esta guía:
Convenciones tipográficas
Las siguientes convenciones tipográficas se utilizan en esta guía:
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
Recursos en línea
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
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 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.
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
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.
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
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ó.
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
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.
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.
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.
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
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
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.
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
<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.
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 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
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
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.
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
4. Repita los pasos 2 y 3 hasta que haya suficiente característica huella digital fija para crear una plantilla de
huellas dactilares.
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.
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
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
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
La verificación de
huellas dactilares
Recuperar la plantilla y
Obtener Identificador
el identificador de
Asunto
Asunto
Leyenda
Realizado por One Touch para Windows SDK: C / C
++ No realizado por One Touch para Windows SDK:
C / C ++
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.
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.
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
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
Leyenda
s One Touch para Windows SDK: COM /
e
ActiveX Paso opcional
de huellas dactilares
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
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).
8. Detener la captura de muestras de huellas digitales llamando al StopCapture método (VB página 36, C ++
página 80).
3. * Pasar los objetos DPFPFeatureSet creados en el paso anterior con el método addFeatures.
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).
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
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
Almacenar nueva
EnroTTedFingersMask
en el subsistema de almacenamiento
Leyenda
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).
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
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).
9. * Establecer el valor apropiado para el objeto DPFPEventHandlerStatus (VB página 71, C ++ página 126).
Leyenda
One Touch para Windows SDK: COM /
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).
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).
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 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
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
recuperar deserializado
DPFPTempTate objeto
Leyenda
U One Touch para Windows SDK: COM /
N
ActiveX Paso opcional
dactilares
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
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).
8. Detener la captura de muestras de huellas digitales llamando al StopCapture método (VB página 36, C ++
página 80).
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).
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
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
recuperar deserializado
DPFPTempTate objetos
Leyenda
U One Touch para Windows SDK: COM /
N
ActiveX Paso opcional
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
5. Recibe el OnComplete evento con el objeto DPFPFeatureSet (VB página 65, C ++ página 120).
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).
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
s
e
Leyenda
One Touch para Windows SDK: Aplicación
La Figura 7. Huella digital objeto de datos de serialización flujo de trabajo: objeto DPFPTemplate
2. Serializar el objeto de datos llamando al Publicar por fascículos método (VB página 40, C ++ página
84).
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
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
Figura 8. Deserialización de flujo de trabajo objeto de datos de huellas digitales en serie: objeto
DPFPTemplate
2. Deserializar un objeto mediante una llamada al DPFPTemplate Deserializar método (VB página 40, C ++
página 83).
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.
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
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
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
posibles errores
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
Información de objeto
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
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
OnFingerTouch Evento
Se activa cuando un usuario toca un lector de huellas digitales.
Sintaxis
Private Sub OnFingerTouch (
ByVal bstrReaderSerNum como secuencia)
Parámetro
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
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
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
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
posibles errores
-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
Información de objeto
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
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
propiedad plantilla
Obtiene un objeto DPFPTemplate creado durante una operación de registro de huellas dactilares.
Sintaxis
[OTemplate =] DPFPEnrollment.Template
Valores posibles
posibles errores
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
Información de objeto
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
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
posibles errores
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
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
Información de objeto
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.
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
posibles errores
Información de objeto
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
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
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
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
posibles errores
-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
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
HardwareRevision propiedad
Obtiene el número de revisión del hardware de un lector de huellas digitales.
Sintaxis
[BstrValue =] DPFPReaderDescription.HardwareRevision
Valores posibles
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
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
ProductName propiedad
Obtiene el nombre de producto de un lector de huellas digitales, por ejemplo, “U.are.U.”
Sintaxis
[BstrValue =] DPFPReaderDescription.ProductName
Valores posibles
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
SerialNumberType propiedad
Obtiene un valor que especifica el tipo de número de serie lector de huellas digitales.
Sintaxis
[EnumValue =] DPFPReaderDescription.SerialNumberType
Valores posibles
tecnología de la propiedad
Obtiene un valor que especifica la tecnología lector de huellas digitales.
Sintaxis
[EnumValue =] DPFPReaderDescription.Technology
Valores posibles
propiedad proveedor
Obtiene el nombre del proveedor para un lector de huellas digitales, por ejemplo, “DigitalPersona, Inc.”
Sintaxis
[BstrValue =] DPFPReaderDescription.Vendor
Valores posibles
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
Información de objeto
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
posibles errores
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
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
posibles errores
_NewEnum propiedad
Obtiene un objeto ReaderEnum (objeto enumeración), que es una matriz de DPFPReaderDescription
objetos.
Sintaxis
[AReaderEnum =] DPFPReadersCollection._NewEnum
Valores posibles
Información de objeto
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
posibles errores
-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
Información de objeto
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.
parámetros
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
Información de objeto
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
posibles errores
-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
Información de objeto
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
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
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
Información de objeto
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
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
Información de objeto
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
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
Información de objeto
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.
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
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
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.
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
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
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
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
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
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
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
observaciones
Los miembros de esta enumeración son llamados por la propiedad de la ImpressionType
DPFPReaderDescription objeto (página 55).
Información enumeración
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
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
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
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
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
observaciones
Los miembros de esta enumeración son llamados por la propiedad de la TemplateStatus
DPFPEnrollment objeto (página 42).
Información enumeración
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.
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 79
desarrollador
Capítulo 6: Referencia API para C ++ Interfaces
Desarrolladores
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.
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:
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
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:
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:
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).
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
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
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
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
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
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.
Sintaxis
HRESULT Deserialize
([in] VARIANT RawData
);
Parámetro
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
Sintaxis
HRESULT Serialize (
[Fuera, retval] VARIANTE * pRawData
);
Parámetro
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.
Sintaxis
AddFeatures HRESULT
([en] IDispatch *
pVal
);
Parámetro
Valor de retorno
Devuelve S_OK si tiene éxito.
Sintaxis
Claro HRESULT (void);
Valor de retorno
Devuelve S_OK si tiene éxito.
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.
Sintaxis
HRESULT IDPFPEnrollment :: get_template
([a cabo, retval] IDispatch ** pVal
);
Parámetro
Valor de retorno
Devuelve S_OK si tiene éxito.
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
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.
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
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:
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:
Información de la interfaz
Personalizado implementación Sí
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).
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.
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
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.
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
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
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
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.
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.
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.
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.
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
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:
Información de la interfaz
Personalizado implementación Sí
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
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.
Sintaxis
HRESULT CreateFeatureSet (
[En] IDispatch * pFingerprintSample,
[en] DPFPDataPurposeEnum Propósito,
[Fuera, retval] DPFPCaptureFeedbackEnum * pSampleQuality
);
parámetros
Valor de retorno
Devuelve S_OK si tiene éxito.
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
Valores devueltos
Devuelve S_OK si tiene éxito, o el valor de error siguiente de otro modo:
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.
Sintaxis
HRESULT Deserialize
([in] VARIANT RawData
);
Parámetro
Valores devueltos
Devuelve S_OK si tiene éxito, o el valor de error siguiente de otro modo:
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
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.
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.
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
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.
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.
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.
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.
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.
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.
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.
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:
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.
Sintaxis
HRESULT IDPFPReadersCollection :: get_Item ([a
cabo, retval] IDispatch ** pVal
);
Parámetro
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 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í
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.
Sintaxis
HRESULT Deserialize
([in] VARIANT RawData
);
Parámetro
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 11
desarrollador 2
Capítulo 6: Referencia API para C ++ Interfaz IDPFPSample
Desarrolladores
Sintaxis
HRESULT Serialize (
[Fuera, retval] VARIANTE * pRawData
);
Parámetro
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.
HRESULT ConvertToANSI381 (
[En] IDispatch * pSample, [a cabo,
retval] VARIANTE * Pansi
);
parámetros
Sintaxis
HRESULT ConvertToPicture
([in] IDispatch *
pSample,
[A cabo, retval] IDispatch ** ppPicture
);
parámetros
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.
Sintaxis
HRESULT Deserialize
([in] VARIANT RawData
);
Parámetro
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 113
desarrollador
Capítulo 6: Referencia API para C ++ Interfaz IDPFPTemplate
Desarrolladores
Sintaxis
HRESULT Serialize (
[Fuera, retval] VARIANTE * pRawData
);
Parámetro
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.
Sintaxis
HRESULT IDPFPVerification :: get_active
([a cabo, retval] VARIANT_BOOL * pVal
);
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.
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:
Sintaxis
Hresult Verify (
[En] IDispatch * pVerificationFeatureSet,
[en] IDispatch * pFingerprintTemplate,
[A cabo, retval] IDispatch ** ppVerificationResult
);
parámetros
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
Valor de retorno
Devuelve S_OK si tiene éxito.
Información de la interfaz
Personalizado implementación Sí
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
Sintaxis
HRESULT IDPFPVerification :: get_active
([a cabo, retval] VARIANT_BOOL * pVal
);
parámetros
pVal [A cabo, retval] Puntero a una variable de tipo booleano que recibe el estado de captura
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
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:
Información de la interfaz
Personalizado implementación Sí
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).
Sintaxis
HRESULT OnComplete (
[En] IDispatch * pVerificationFeatureSet,
[en] IDispatch * pStatus
);
parámetros
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.
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.
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.
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
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
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
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.
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).
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).
Sintaxis
typedef enum {DPFPEventHandlerStatusEnum
EventHandlerStatusSuccess = 0,
EventHandlerStatusFailure = 1,
DPFPEventHandlerStatusEnum};
constantes
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).
Sintaxis
typedef enum {DPFPDataPurposeEnum
DataPurposeUnknown = 0,
DataPurposeVerification = 1,
DataPurposeEnrollment = 2,
DPFPDataPurposeEnum};
constantes
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).
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
Sintaxis
typedef enum {DPFPReaderImpressionTypeEnum
ReaderImpressionTypeUnknown = 0,
ReaderImpressionTypeSwipe = 1,
ReaderImpressionTypeArea = 2,
DPFPReaderImpressionTypeEnum};
constantes
observaciones
Los miembros de este tipo enumerado son llamados por el
IDPFPReaderDescription :: ImpressionType propiedad (página 102).
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
observaciones
Los miembros de este tipo enumerado son llamados por el IDPFPReaderDescription :: Tecnología
propiedad (página 104).
Sintaxis
typedef enum {DPFPSerialNumberTypeEnum
SerialNumberTypePersistent = 0,
SerialNumberTypeVolatile = 1,
DPFPSerialNumberTypeEnum};
constantes
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
Sintaxis
typedef enum {DPFPTemplateStatusEnum
TemplateStatusUnknown = 0,
TemplateStatusInsufficient = 1,
TemplateStatusFailed = 2,
TemplateStatusReady = 3,
DPFPTemplateStatusEnum};
constantes
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).
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 ++.
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.
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
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
inscripción?
huella digital
inscripción?
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.
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
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.
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.
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
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.
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.
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
Indica que el lector de huellas digitales está conectado y listo para que el
usuario escanear un dedo.
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.
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:
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.
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
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
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
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.
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.)
INT_N = P * PROBABILITY_ONE
INT_N
P=
PROBABILITY_ONE
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 149
desarrollador
Apéndice A: Ajuste de la velocidad
Aceptar Falso
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.
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%.
IDPFPVerification * verificación;
...
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.
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>
CComVariant varVal;
varVal.vt = VT_ARRAY | VT_UI1;
varVal.parray = SafeArrayCreate (VT_UI1, 1, y rgsabound);
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;
si (goldBufferSize <blobSizeRequired)
{SafeArrayUnaccessData
(varValGold.parray); falso retorno;
}
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
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
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 152
desarrollador
Glosario
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.
inscrita
Ver Datos sujetos de huellas dactilares.
inscripción
Ver 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.
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
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
DigitalPersona One Touch para Windows SDK: COM / ActiveX Edición | Guía del 161
desarrollador
Índic T
e
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