df_fingerprint.h-Dateireferenz

#include "df_defines.h"

gehe zum Quellcode dieser Datei

Funktionen
int DF_API_CALL	DFCFingerprintAppendRecord (int connectionNumber, int deviceAddress, int templateType, const unsigned char *buffer, int bufferSize, int *errorNumber)
	Anfügen eines Fingertemplates an die Datentabelle des Fingerprints. Siehe auch Behandlung von Fingertemplates.
int DF_API_CALL	DFCFingerprintGetRecord (int connectionNumber, int deviceAddress, int templateType, int pid, int fid, unsigned char *buffer, int *bufferSize, int *errorNumber)
	Lesen eines Fingertemplates.
int DF_API_CALL	DFCFingerprintDeleteRecord (int connectionNumber, int deviceAddress, int pid, int fid, int *errorNumber)
	Löschen von Fingertemplates.
int DF_API_CALL	DFCFingerprintList (int connectionNumber, int deviceAddress, int flags, int *errorNumber)
	Erzeugen einer Systemliste (FINGERPRINT.IDLIST) aller enthaltener Personal-Id's und zugehöriger Finger-Id's.
int DF_API_CALL	DFCFingerprintBackup (int connectionNumber, int deviceAddress, const char *filePath, int flags, int *errorNumber)
	Backupdatei mit allen Fingertemplates erzeugen.
int DF_API_CALL	DFCFingerprintRestore (int connectionNumber, int deviceAddress, const char *filePath, int flags, int *errorNumber)
	Backupdatei mit Fingertemplates auf ein Gerät übertragen.

Dokumentation der Funktionen

DFCFingerprintAppendRecord()

int DF_API_CALL DFCFingerprintAppendRecord	(	int	connectionNumber,
		int	deviceAddress,
		int	templateType,
		const unsigned char *	buffer,
		int	bufferSize,
		int *	errorNumber
	)

Anfügen eines Fingertemplates an die Datentabelle des Fingerprints. Siehe auch Behandlung von Fingertemplates.

Export

DFComDLL als _DFCFingerprintAppendRecord@24
DFCom_x64 als DFCFingerprintAppendRecord

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	templateType	Templatetyp der übergeben wird. Wert Bedeutung 0 DIN V66400 (161 Byte) 1 Idencom-Compact (216 Byte) 2 Idencom-Standard (561) 3 Saturn (635 Byte)
[in]	buffer	Datenarray des Templates.
[in]	bufferSize	Die Länge des Datenarrays.
[out]	errorNumber	Fehlernummer bei fehlerhafter Ausführung.

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.

Seit

04.01.04 enthalten

DFCFingerprintBackup()

int DF_API_CALL DFCFingerprintBackup	(	int	connectionNumber,
		int	deviceAddress,
		const char *	filePath,
		int	flags,
		int *	errorNumber
	)

Backupdatei mit allen Fingertemplates erzeugen.

Es werden alle Fingertemplates ausgelesen und in die angegebene Datei gespeichert. Durch Aufruf von DFCFingerprintRestore() kann die Datei dann ggf. auf andere Terminals übertragen werden.

Export

DFComDLL als _DFCFingerprintBackup@20
DFCom_x64 als DFCFingerprintBackup

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	filePath	Dateiname der zu erstellenden Backupdatei.
[in]	flags	Reservierter Parameter. Standardwert 0.
[out]	errorNumber	Fehlernummer bei fehlerhafter Ausführung.

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.

Seit

04.01.07 enthalten

DFCFingerprintDeleteRecord()

int DF_API_CALL DFCFingerprintDeleteRecord	(	int	connectionNumber,
		int	deviceAddress,
		int	pid,
		int	fid,
		int *	errorNumber
	)

Löschen von Fingertemplates.

Sie können einzelne Templates durch Angabe des entsprechenden Personal-Id, Finger-Id Pärchens löschen. Es ist auch möglich durch Angabe einer Personal-Id und einer Finger-Id = 0, alle Fingertemplates zu dieser Personal-Id zu löschen. Wird eine Personal-Id = 0 und Finger-Id = 0 angegeben, werden alle Fingertemplates des Moduls gelöscht.

Export

DFComDLL als _DFCFingerprintDeleteRecord@20
DFCom_x64 als DFCFingerprintDeleteRecord

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	pid	Personal-Id des Templates.
[in]	fid	Finger-Id des Templates.
[out]	errorNumber	Fehlernummer bei fehlerhafter Ausführung.

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.

Seit

04.01.04 enthalten

DFCFingerprintGetRecord()

int DF_API_CALL DFCFingerprintGetRecord	(	int	connectionNumber,
		int	deviceAddress,
		int	templateType,
		int	pid,
		int	fid,
		unsigned char *	buffer,
		int *	bufferSize,
		int *	errorNumber
	)

Lesen eines Fingertemplates.

Über die eindeutige Kombination aus Personal-Id (PID)/ Finger-Id (FID) können mit dieser Funktion die entsprechenden Templatedaten ermittelt werden.

Export

DFComDLL als _DFCFingerprintGetRecord@32
DFCom_x64 als DFCFingerprintGetRecord

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	templateType	Templatetyp wie bei DFCFingerprintAppendRecord() beschrieben.
[in]	pid	Personal-Id des Templates.
[in]	fid	Finger-Id des Templates.
[out]	buffer	Datenarray für das Template.
[in,out]	bufferSize	Als in die Länge des Datenarrays von buffer, als out die übergebene Anzahl Datenbytes.
[out]	errorNumber	Fehlernummer bei fehlerhafter Ausführung.

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.

Seit

04.01.04 enthalten

DFCFingerprintList()

int DF_API_CALL DFCFingerprintList	(	int	connectionNumber,
		int	deviceAddress,
		int	flags,
		int *	errorNumber
	)

Erzeugen einer Systemliste (FINGERPRINT.IDLIST) aller enthaltener Personal-Id's und zugehöriger Finger-Id's.

Es wird eine Liste FINGERPRINT.IDLIST erzeugt mit 2 Spalten PID und FID die alle auf dem Modul enthaltenen Personal-Id und Finger-Id's der Templates enthält. Mit diesen Daten können dann mit DFCFingerprintGetRecord() alle Fingertemplates ausgelesen werden.
Auf die erstellte Liste können Sie mit den Funktionen für das Listeneditieren wie DFCTableOpen() zugreifen.

Export

DFComDLL als _DFCFingerprintList@16
DFCom_x64 als DFCFingerprintList

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	flags	Flags für zusätzliche Angaben. Bitnummer Wert Bedeutung 1 1 Wird dieses Flag gesetzt, liefert die Funktion die Anzahl der Datensätze der Liste zurück. Wenn keine Datensätze vorliegen bricht die Funktion mit einem Fehler ab. Eine Datensatzanzahl von 0 gibt es somit nicht. ... Nicht verwendet. Bitte immer 0 übergeben.
[out]	errorNumber	Fehlernummer bei fehlerhafter Ausführung.

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.
>0	Bei Angabe des flags 1 wird die Anzahl der Listensätze geliefert.

Seit

04.01.07 enthalten

DFCFingerprintRestore()

int DF_API_CALL DFCFingerprintRestore	(	int	connectionNumber,
		int	deviceAddress,
		const char *	filePath,
		int	flags,
		int *	errorNumber
	)

Backupdatei mit Fingertemplates auf ein Gerät übertragen.

Es wird eine mit DFCFingerprintBackup() erstellte Backupdatei auf das Gerät übertragen.

Export

DFComDLL als _DFCFingerprintRestore@20
DFCom_x64 als DFCFingerprintRestore

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	filePath	Dateiname der zu übertragenden Backupdatei.
[in]	flags	Reservierter Parameter. Standardwert 0. Bitnummer Wert Bedeutung 1 1 Vor der Übertragung werden durch Aufruf der Löschfunktion alle auf dem Modul enthaltenden Templates gelöscht. ... Nicht verwendet. Bitte immer 0 übergeben.
[out]	errorNumber	Fehlernummer bei fehlerhafter Ausführung.

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.

Seit

04.01.07 enthalten