Biometric Device SDK - Programmers Guide - En.es
Biometric Device SDK - Programmers Guide - En.es
2
1. Introduccin
Printsdk es el kit de desarrollo de software para impresin incorporado machine.it huella digital puede desarrollar un programa de comunicacin con el ejemplo machine.for
incorporado, puede obtener informacin de los usuarios registrados del dispositivo, o ajustar la informacin del usuario al dispositivo, la informacin puede ser contener el nombre
de usuario, contrasea de usuario , privilegios de usuario o una plantilla de huella digital del usuario, y se puede administrar dispositivo en computer.end se puede obtener en los
Instalacin:
copiar todos los archivos dll a la carpeta de sistema o carpeta actual de que la ejecucin del programa. A continuacin, ejecute regsvr32.exe para registrar los
Nota:
Funciones de zkemkeeper que no en este documento no se apoyan. Parmetro dwEMachineNumber es igual dwMachineNumber, dwEMachineNumber slo
para compatible con la versin antigua.
3
2. Mtodo
2.1 GetEnrollData
[Funcin]
Descargar plantilla de la huella digital del usuario inscrito desde el dispositivo
[Protocolo]
BOOL GetEnrollData (
largo dwMachineNumber,
largo dwEnrollNumber,
largo dwEMachineNumber,
largo dwBackupNumber,
larga FAR * dwMachinePrivilege, a largo FAR *
dwEnrollData, a largo FAR * dwPassWord);
[Parmetros]
dwMachineNumber
La mquina Nmero de dispositivo operativo
dwEMachineNumber
igual a dwMachineNumber
dwEnrollNumber
El ID de usuario
dwBackupNumber
La copia de seguridad nmero del usuario, significa Nmero de copia de seguridad
Valor Descripcin
0 Plantilla de huella digital 0
1 Plantilla de huella digital 1
2 Plantilla de huellas digitales 2
10 Contrasea
dwMachinePrivilege
El privilegio del usuario en el dispositivo, de la siguiente manera:
Valor Descripcin 0
1 usuario en general
dwEnrollData
El puntero de memoria intermedia para guardar plantilla de huellas dactilares, tamao del bfer debe grande o Ecuat de 1836 bytes.
4
dwPassWord
La contrasea.
[Regreso]
[Nota]
Si dwBackupNumber est entre 0 y 9, la plantilla de la huella digital especificada guarda en una memoria intermedia, que parmetro
dwEnrollData seal. Y el parmetro dwPassWord se ignora. Por otro lado, si dwBackupNumberValue IS10, la contrasea se guarda en
dwPassWord, y el parmetro dwEnrollData se ignora.
2.2 SetEnrollData
[Funcin]
Cargar una plantilla de huellas dactilares usuario especificado a un dispositivo, existe sobrescribir los datos del usuario.
[Protocolo]
BOOL SetEnrollData (
largo dwMachineNumber,
largo dwEnrollNumber,
largo dwEMachineNumber,
largo dwBackupNumber,
largo dwMachinePrivilege,
larga FAR * dwEnrollData, a largo
dwPassWord);
[Parametros]
dwMachineNumber
La mquina Nmero de dispositivo operativo
dwEnrollNumber
El ID de usuario
dwEMachineNumber
igual a dwMachineNumber
dwBackupNumber
ver Mtodo GetEnrollData
dwMachinePrivilege
privilegios del usuario de este dispositivo
dwEnrollData
La plantilla de huella dactilar. Si es dwBackupNumber 10 se puede ignorar
dwPassWord
La contrasea del usuario. Si dwBackupNumber menos de 10 se puede ignorar.
[Regreso]
2.3 GetUserTmp
5
Descargar plantilla de la huella digital del usuario inscrito desde la velocidad de device.It ms rpido que la funcin GetEnrollData
2.4 SetUserTmp
Cargar una plantilla de huellas dactilares usuario especificado a un dispositivo, existe sobrescribir el data.it del usuario subir la huella digital para el dispositivo directamente, por lo
que el dispositivo puede tener las mismas huellas digitales, es diferente de SetEnrollData.the velocidad ms rpida que SetEnrollData
2.5 DeleteEnrollData
[Funcin]
Eliminar plantilla de la huella digital del usuario registrado.
[Protocolo]
BOOL DeleteEnrollData (
largo dwMachineNumber,
largo dwEnrollNumber,
largo dwEMachineNumber,
largo dwBackupNumber);
[Parametros]
Ver GetEnrollData
[Regreso]
[Notas]
Si no hay ningn usuario especificado en el dispositivo, devolver TRUE.
Si dwBackupNumberValue es de 11, todos de la plantilla de huella digital del usuario, que especifica por dwEnrollNumber, sern eliminados.
Si dwBackupNumberValue es de 12, todos plantilla de huellas dactilares y la contrasea del usuario, que especifica por dwEnrollNumber, sern
eliminados.
2.6 DelUserTmp
Slo Eliminar una plantilla de la huella digital de un usuario incluido.
2.7 ReadGeneralLogData
[Funcin]
Leer los registros transication generales (datos de asistencia) en buffer interno de dispositivo.
[Protocolo]
BOOL ReadGeneralLogData (
largo dwMachineNumber);
[Parametros]
dwMachineNumber
La mquina Nmero de dispositivo operativo
[Regreso]
6
[Notas]
Despus ReadGeneralLogData de llamada para leer los datos de amortiguar, puede llamar GetGeneralLogData para obtener todos los registros del registro.
2.8 GetGeneralLogData
[Funcin]
Obtener un registro de registro del buffer interno, que llen por ReadGeneralLogData.
[Protocolo]
BOOL GetGeneralLogData (
larga dwMachineNumber, a largo FAR *
dwTMachineNumber, a largo FAR * dwEnrollNumber,
a largo FAR * dwEMachineNumber, a largo FAR *
dwVerifyMode, a largo FAR * dwInOutMode, a largo
FAR * dwYear, a largo FAR * dwMonth, a largo FAR *
dwDay, a largo FAR * dwHour, a largo FAR *
dwMinute);
[Parametros]
dwMachineNumber
La mquina Nmero de dispositivo operativo
dwTMachineNumber
La mquina Nmero de dispositivo, donde se verifica el usuario.
dwEnrollNumber
El ID de usuario.
dwEMachineNumber
igual a dwMachineNumber
dwVerifyMode
El mtodo de una verificacin exitosa. Es la siguiente manera:
Valor Descripcin
1 Fingeprint
2 Contrasea
dwInOutMode
El estado de asistencia. Es la siguiente manera:
Valor Descripcin 0
El 1 de deber
Fuera de
5 de Bloqueo
Encerrar
dwYear,
dwMonth,
dwDay,
7
dwHour,
dwMinute
Las diferentes partes de la fecha y la hora.
[Regreso]
[Notas]
Llamar ReadGeneralLogData para leer datos en el buffer interno antes de este mtodo. Se le puede llamar varias veces hasta que vuelva FALSO para conseguir
todos los registros. Ver tambin Mtodo ReadGeneralLogData
2.9 ReadAllGLogData
mismas ReadGeneralLogData
2.10 GetAllGLogData
mismas GetGeneralLogData
2.11 GetDeviceStatus
[Funcin]
Obtener el estado del dispositivo.
[Protocolo]
BOOL GetDeviceStatus (
largo dwMachineNumber,
largo dwStatus,
larga FAR * dwValue);
[Parametros]
dwMachineNumber
La mquina Nmero de dispositivo operativo
dwStatus
Indicar qu estado. Es la siguiente manera:
Valor Descripcin
1 Conde de administradores
2 Contar los usuarios od
4 Conde de contrasea.
5 Contar de nuevo inicia la administracin transication.
6 Conde de los nuevos registros generales
dwValue
El valor devuelto.
[Regreso]
8
2.12 GetDeviceInfo
[Funcin]
Recibe las opciones de un dispositivo.
[Protocolo]
BOOL GetDeviceInfo (
largo dwMachineNumber,
largo dwInfo,
larga FAR * dwValue);
[Parametros]
dwMachineNumber
La mquina Nmero de dispositivo operativo
dwInfo
Indicar qu opcin. Es la siguiente manera:
1. Nmero mximo de administrador. El valor es de 0-10.
2. Nmero de mquina del dispositivo. El valor es de 1 a 255.
3. Valor Idioma
decription
0 Ingls 1
2 china
coreano
4. Auto hora del dispositivo de cierre (minutos). Este valor es de 0 a 255.
5. Bloqueo de Open Value de control de
salida Descripcin
0 Salida de seal de bloqueo abierto 1
13.Network
14.RS232
15.RS485
16.Voice
velocidad 17.Identification
9
18.idle
tiempo 19.Shutdown
tiempo 20.PowerOn
tiempo 21.Sleep
22.Auto Campana
threhold 23.Match
threhold 24.Register
25.1: 1 threhold
puntuacin 26.Show
29.Net velocidad
formiato 34.Date
35.Only 1: 1
dwValue
El valor devuelto.
[Regreso]
2.13 SetDeviceInfo
[Funcin]
Establecer las opciones de un dispositivo.
[Protocolo]
BOOL SetDeviceInfo (
largo dwMachineNumber,
largo dwInfo,
largo dwValue);
[Parametros]
dwMachineNumber
ID del dispositivo
dwInfo
Dispositivo ndice de informacin
Tasa 9.Baud
10.Even y Odd
poco 11.Stop
12.Date separador de listas
No apoyo ahora, pero se puede aplicar lo utilice informacin del dispositivo objeto 34 Fecha llamado formato, los pls refieren a dwValue 34.
13.Network
10
14.RS232
15.RS485
16.Voice
velocidad 17.Identification
18.idle
tiempo 19.Shutdown
tiempo 20.PowerOn
tiempo 21.Sleep
22.Auto Campana
threhold 23.Match
threhold 24.Register
25.1: 1 threhold
puntuacin 26.Show
29.Net velocidad
formiato 34.Date
35.Only 1: 1
dwValue
1.Registrable administradores de serie
2.Device ID
3.Languages Valor
Descripcin
0 Ingls,
1 chino simplificado
2 Chino tradicional
4.Auto el tiempo de apagado
Tasa 9.Baud
10.Even y Odd
poco 11.Stop
12.Date separador de listas
13.Network
14.RS232
15.RS485
16.Voice
velocidad 17.Identification
18.idle
tiempo 19.Shutdown
tiempo 20.PowerOn
tiempo 21.Sleep
22.Auto Campana
umbral 23.Match
umbral 24.Register
25.1: 1 umbral
puntuacin 26.Show
29.Net velocidad
11
tarjeta de empadronados 30.Must
34.Date Valor
formiato Descripcin
0 YY-MM-DD
1 YY / MM / DD
3 AA.MM.DD
4 MM-DD-YY
5 MM / DD / YY
6 MM.DD.AA
7 DD-MM-YY
8 DD / MM / YY
9 DD.MM.AA
10 AAAAMMDD
35.Only 1: 1
Slo 1: 1 verificar mode.0: Falso, 1: verdadero.
[Regreso]
2.14 EnableDevice
[Funcin]
Permitir / no permitir al usuario frente a operar el dispositivo.
[Protocolo]
BOOL EnableDevice (
largo dwMachineNumber,
BOOL bFlag);
[Parametros]
dwMachineNumber
La mquina Nmero de dispositivo operativo
bFlag
medios TRUE permiten teclas de entrada de usuario y de huellas digitales, medios falso no permiten
[Regreso]
[Notas]
Por favor llame EnableDevice con bFlag = FALSE para deshabilitar la operacin del usuario delante antes de llamar a otras funciones para intercambiar datos entre el
anfitrin y el dispositivo, como ReadGenealLogData, GetEnrollData etc, y llamar EnableDevice con bFlag = TRUE despus de terminar sus transacciones.
2.15 EnableUser
[Funcin]
12
Habilitar o deshabilitar un usuario.
[Protocolo]
[Parametros]
bFlag
TRUE significa que permiten al usuario, mediante FALSO l deshabilitar / ella. Otros
parmetros vase el mtodo GetEnrollData .
[Regreso]
2.16 SetDeviceTime
[Funcin]
Ajuste la fecha y hora del dispositivo.
[Protocolo]
BOOL SetDeviceTime (
largo dwMachineNumber);
[Parametros]
dwMachineNumber
La mquina Nmero de dispositivo operativo
[Regreso]
[Notas]
Este mtodo establece la fecha y la hora dispositivo mismo como anfitrin.
2.17 GetDeviceTime
[Funcin]
Obtener la fecha y hora del dispositivo.
[Protocolo]
BOOL GetDeviceTime (
largo dwMachineNumber,
larga FAR * dwYear, a largo FAR *
dwMonth, a largo FAR * dwDay, a
largo FAR * dwHour,
13
larga FAR * dwMinute, a largo FAR *
dwDayOfWeek);
[Parametros]
dwMachineNumber
La mquina Nmero de dispositivo operativo
dwYear,
dwMonth,
dwDay,
dwHour,
dwMinute
Las diferentes partes de la fecha de dispositivo.
dwDayOfWeek
El Da de la semana de la fecha de dispositivo
[Regreso]
2.19 PowerOffDevice
[Funcin]
Apagar el dispositivo.
[Protocolo]
BOOL PowerOffDevice (
largo dwMachineNumber);
[Parametros]
dwMachineNumber
La mquina Nmero de dispositivo operativo
[Regreso]
2.20 ModifyPrivilege
[Funcin]
Modificar privilegios de un usuario en un dispositivo.
[Protocolo]
BOOL ModifyPrivilege (
largo dwMachineNumber,
largo dwEnrollNumber,
largo dwEMachineNumber,
largo dwBackupNumber,
largo dwMachinePrivilege);
14
[Parametros]
[Regreso]
2.21 ReadAllUserID
[Funcin]
Leer todos los ID de usuario de dispositivo en el buffer interno.
[Protocolo]
BOOL ReadAllUserID (
largo dwMachineNumber);
[Parametros]
dwMachineNumber
La mquina Nmero de dispositivo operativo
[Regreso]
Llamar al mtodo GetAllUserID para obtener todos los registros de identificacin de usuario.
2.22 GetAllUserID
[Funcin]
Leer un registro de ID de usuario de la memoria intermedia que ReadAllUserID llena.
[Protocolo]
BOOL GetAllUserID (
dwMachineNumber larga, larga FAR * dwEnrollNumber, a
largo FAR * dwEMachineNumber, a largo FAR *
dwBackupNumber, a largo FAR * dwMachinePrivilege, a
largo FAR * dwEnable);
[Parametros]
dwEnable
Indica si el usuario est habilitado. Valor 1 significa que un usuario normal (activado), y el valor 2 significa usuario deshabilitado.
[Regreso]
[Notas]
GetAllUserID llamar repetidamente hasta que vuelva FALSO para obtener todos ellos.
15
2.23 GetSerialNumber
[Funcin]
Obtener la informacin del producto o el nmero de serie
[Protocolo]
BOOL GetSerialNumber (
dwMachineNumber larga, BSTR FAR *
lpszSerialNumber);
[Parametros]
dwMachineNumber
La mquina Nmero de dispositivo operativo
lpszSerialNumber
La cadena devuelta
[Regreso]
2.24 ClearKeeperData
[Funcin]
Eliminar todo el nombre de usuario administrador inscrito / plantillas de huellas digitales y en los registros de entrada / salida.
[Protocolo]
BOOL ClearKeeperData (
dwMachineNumber larga) ;
[Parametros]
dwMachineNumber
La mquina Nmero de dispositivo operativo
[Regreso]
2.25 ClearAdministrators
[Funcin]
Borrar todos los privilegios de administrador en el dispositivo.
[Protocolo]
[Parametros]
dwMachineNumber
La mquina Nmero de dispositivo operativo
[Regreso]
[Funcin]
Obtener la versin del firmware del dispositivo.
[Protocolo]
[Parametros]
dwMachineNumber
La mquina Nmero de dispositivo operativo
strVersion
Versin de firmware.
[Regreso]
2,27 GetSDKVersion
Obtenga la versin zkemkeeper.
2,28 ClearGLog
Borrar todos los registros del dispositivo.
2.29 GetFPTempLength
Obtiene la longitud de plantilla de huellas dactilares.
[Funcin]
Conectarse al dispositivo a travs del puerto COM.
[Protocolo]
[Parametros]
Portarse
nmero de puerto COM
Nmero de mquina
La mquina Nmero de dispositivo operativo
BaudRate
comunicacin BaudRate
[Regreso]
2,31 Connect_Net
[Funcin]
Conectarse al dispositivo mediante Ethernet
[Protocolo]
[Parametros]
IPAdd
17
direccin IP
Puerto
nmero de puerto, por defecto 4370
[Regreso]
2.32 Desconectar
Desconectar con dispositivo.
2,33 setUserInfo
[Funcin]
Establecer informacin del usuario a la informacin de device.user contiene el nombre de usuario y contrasea.
[Protocolo]
SetUserInfo (dwMachineNumber As Long, dwEnrollNumber As Long, Nombre As String, contrasea como secuencia, de privilegios como de largo,
Activado As Boolean) As Boolean
[Parametros]
dwMachineNumber
La mquina Nmero de dispositivo operativo
dwEnrollNumber
Inscribirse nmero que desea establecer
Nombre
Nombre de usuario
Contrasea
Contrasea de usuario
Privilegio
privilegios de usuario
Activado
si el usuario habilitado
[Regreso]
2.34 GetUserInfo
[Funcin]
Obtener informacin del usuario desde el dispositivo. informacin del usuario contiene el nombre de usuario y contrasea.
[Protocolo]
SetUserInfo (dwMachineNumber As Long, dwEnrollNumber As Long, Nombre As String, contrasea como secuencia, de privilegios como de largo,
Activado As Boolean) As Boolean
[Parametros]
dwMachineNumber
La mquina Nmero de dispositivo operativo
dwEnrollNumber
Inscribirse nmero t
Nombre
Nombre de usuario
Contrasea
Contrasea de usuario
Privilegio
privilegios de usuario
Activado
18
si el usuario habilitado
[Regreso]
2.35 SetDeviceIP
Configurar la direccin IP del dispositivo.
2,36 GetDeviceIP
Obtener la direccin IP del dispositivo.
2,37 FPTempConvert
Convertir la plantilla de la huella digital del dispositivo de plantilla de huellas dactilares Biokey, entonces se puede verificar la huella digital en el ordenador por
Biokey.Biokey SDK es BioLife kit FC desarrollo de huellas digitales en lnea.
2,38 GetSerialNumber
Obtener nmero de serie del dispositivo.
2,39 SetCommPassword
[Funcin]
Establecer la comunicacin con contrasea connection.The contrasea puede rechazar la conexin no autorizada.
[Protocolo]
[Parametros]
Commkey
La comunicacin password.for ejemplo: si la contrasea es 123456, entonces CommKey = 123456
[Regreso]
[Notas]
2.40 GetSMS
[Funcin]
Obtener SMS
[Protocolo]
[Parametros]
dwIndex
ndice de SMS
dwEnrollNumber
el ID de usuario del SMS
SMS
Valor del SMS
[Regreso]
19
[Notas]
2.41 SetSMS
[Funcin]
conjunto de SMS
[Protocolo]
[Parametros]
dwIndex
ndice de SMS
dwEnrollNumber
especificar el ID de usuario del SMS
SMS
Valor del SMS
[Regreso]
[Notas]
2,42 imagenDeCaptura
[Funcin]
Capturar la imagen actual del escner de huellas digitales
[Protocolo]
ImagenDeCaptura (fullimage As Boolean, ancho como de largo, altura como de largo, Imagen As Byte, ImageFile As String) As Boolean
[Parametros]
Imagen completa
Si es cierto, la funcin devolver la imagen completa, de lo contrario, devolver imagen vlida, la imagen es la imagen vlida para
verificar.
Anchura
Altura
especificar la altura de la imagen
Imagen
matriz de bytes de imagen
Archivo de imagen
Archivo de imagen
[Regreso]
[Notas]
2,43 UpdateFirmware
20
[Funcin]
Actualice el firmware
[Protocolo]
[Parametros]
archivo de firmware
firmware archivo
[Regreso]
[Notas]
2,44 backupdata
[Funcin]
los datos de usuario de copia de seguridad de dispositivo, contienen ID de usuario, contrasea, huella digital, registro, etc.
[Protocolo]
[Parametros]
Archivo de datos
[Regreso]
[Notas]
2,45 RestoreData
[Funcin]
Restaurar los datos de copia de seguridad que antes.
[Protocolo]
[Parametros]
Archivo de datos
[Regreso]
[Notas]
2,46 WriteLCD
21
[Funcin]
Escribe LCD de Devie
[Protocolo]
WriteLCD (fila como de largo, Col como de largo, Texto As String) As Boolean
[Parametros]
Fila
Col
texto
[Regreso]
[Notas]
2.47ClearLCD
[Funcin]
Clear LCD de Devie
[Protocolo]
ClearLCD () As Boolean
[Parametros]
[Regreso]
[Notas]
2,48 Bip
[Funcin]
Pitido del zumbador
[Protocolo]
[Parametros]
DelayMS
milisegundos de retardo
[Regreso]
[Notas]
2.49 PlayVoiceByIndex
[Funcin]
22
Reproducir voz
[Protocolo]
[Parametros]
ndice
ndice de voz.
[Regreso]
[Notas]
2.50 ACUnlock
[Funcin]
enviar una seal de desbloqueo.
[Protocolo]
[Parametros]
dwMachineNumber
ID del dispositivo.
[Regreso]
[Notas]
2,51 GetUserGroup
[Funcin]
GetUserGroup
[Protocolo]
[Parametros]
dwMachineNumber
Dispositivo UserGrp ID
dwEnrollNumber ID de
usuario
[Regreso]
[Notas]
23
2,52 SetUserGroup
[Funcin]
grupo creado para el usuario ..
[Protocolo]
[Parametros]
dwMachineNumber
ID del dispositivo.
dwEnrollNumber
Identidad de usuario
UserGrp
Grupo de usuario
[Regreso]
[Notas]
2,53 GetTZInfo
[Funcin]
Obtener informacin de zona horaria.
[Protocolo]
[Parametros]
dwMachineNumber
ID del dispositivo.
TZIndex
ndice de zona horaria
TZ
cadena de zona horaria.
[Regreso]
[Notas]
2,54 SetTZInfo
[Funcin]
Establecer zona horaria inforamtion
[Protocolo]
24
[Parametros]
dwMachineNumber
ID del dispositivo.
TZIndex
ndice de zona horaria
TZ
cadena de zona horaria
[Regreso]
[Notas]
2,55 GetUnlockGroups
[Funcin]
Obtener grupos de desbloqueo
[Protocolo]
[Parametros]
dwMachineNumber
ID del dispositivo.
grps
grupos
[Regreso]
[Notas]
2,56 SetUnlockGroups
[Funcin]
grupos establecidos de desbloqueo
[Protocolo]
[Parametros]
dwMachineNumber
ID del dispositivo.
grps
cadena de grupos
[Regreso]
[Notas]
25
2,57 GetGroupTZStr
[Funcin]
Recibe las zonas horarias del Grupo.
[Protocolo]
dwMachineNumber
ID del dispositivo.
groupIndex Tzs
Zonas horarias
[Regreso]
[Notas]
2,58 SetGroupTZStr
[Funcin]
Conjunto de grupos de zona horaria.
[Protocolo]
[Parametros]
dwMachineNumber
ID del dispositivo.
groupIndex Tzs
[Regreso]
[Notas]
2.59 GetUserTZStr
[Funcin]
Obtener zona horaria del usuario.
[Protocolo]
[Parametros]
dwMachineNumber
ID del dispositivo.
dwEnrollNumber
26
Identidad de usuario
Tzs
Zonas horarias
[Regreso]
[Notas]
2.60 SetUserTZStr
[Funcin]
Establecer zonas horarias de los usuarios
[Protocolo]
[Parametros]
dwMachineNumber
ID del dispositivo.
dwEnrollNumber ID de
usuario
Tzs
Zonas horarias
[Regreso]
[Notas]
2,61 GetLastError
[Funcin]
Obtener nmero de error pasado.
[Protocolo]
BOOL GetLastError (
larga FAR * dwErrorCode);
[Parametros]
dwErrorCode
El nmero de error devuelto
Valor Descripcin 1
successed 4
ERR_INVALID_PARAM 0
ERR_NO_DATA
-1 ERROR_NOT_INIT
-2 ERROR_IO
-3 error_size
-4 ERROR_NO_SPACE
- 100 ERROR_UNSUPPORT
27
[Regreso]
[Notas]
dwErrorCode = 6 causada por la llamada al mtodo GetGeneralLogData y GetAllGLogData . Si los devuelven FALSO, por favor
llame a GetLastError para determinar si hay un error o leer sobre los datos.
28