#include "df_defines.h"

Funktionen
void DF_API_CALL	DFCClrListenBuffer (int connectionNumber)
	Bibliotheksinterne Datenpuffer für Setuplisten löschen und initalisieren.

int DF_API_CALL	DFCMakeListe (int connectionNumber, int number, int recordCount, int size, const unsigned char *buffer, int unused_setTo0)
	Kopieren eines aufbereiteten Datenarrays für eine Setupliste in den biblioteksinternen Datenpuffer.

int DF_API_CALL	DFCLoadListen (int connectionNumber, int deviceAddress, int *errorNumber)
	Übertragen der bibliotheksinternen Datenpuffer zum Gerät.

int DF_API_CALL	DFCLoadListenbeschreibung (int connectionNumber, int deviceAddress, int *errorNumber)
	Aufbau der Listentabellen aus dem Geräte lesen.

int DF_API_CALL	DFCListBCnt (int connectionNumber)
	Anzahl der gelesenen Listentabellen abrufen.

int DF_API_CALL	DFCListBDatensatz (int connectionNumber, int number, char name, int fieldCount, int *unused_setTo0)
	Grunddaten einer Listentabelle abrufen.

int DF_API_CALL	DFCListBFeld (int connectionNumber, int listBNumber, int number, char name, int type, int *size)
	Grunddaten eines Listenfeldes abrufen.

Dokumentation der Funktionen

◆ DFCClrListenBuffer()

void DF_API_CALL DFCClrListenBuffer ( int connectionNumber )

Bibliotheksinterne Datenpuffer für Setuplisten löschen und initalisieren.

Die in der Bibliothek bereitgestellten Datenpuffer für die zu übertragenenden Listendaten werden gelöscht und für eine Verwendung mittels DFCMakeListe() und DFCLoadListen() initalisiert.

Export: DFComDLL als _DFCClrListenBuffer@4
DFCom_x64 als DFCClrListenBuffer

Parameter

[in] connectionNumber Zu verwendende Verbindungsnummer.

◆ DFCListBCnt()

int DF_API_CALL DFCListBCnt ( int connectionNumber )

Anzahl der gelesenen Listentabellen abrufen.

Auf Grundlage der zuvor mit DFCLoadListenbeschreibung() gelesenen Listentabellen, wird die im Gerätesetup definierte Anzahl zurückgegeben.

Export: DFComDLL als _DFCListBCnt@4
DFCom_x64 als DFCListBCnt

Parameter

[in] connectionNumber Zu verwendende Verbindungsnummer.

Rückgabe: Anzahl der Listentabellen.

◆ DFCListBDatensatz()

int DF_API_CALL DFCListBDatensatz	(	int	connectionNumber,
		int	number,
		char *	name,
		int *	fieldCount,
		int *	unused_setTo0
	)

Grunddaten einer Listentabelle abrufen.

Auf Grundlage der zuvor mit DFCLoadListenbeschreibung() gelesenen Listentabellen, werden die Grunddaten zu einer Listentabelle zurückgegeben.

Export: DFComDLL als _DFCListBDatensatz@20
DFCom_x64 als DFCListBDatensatz

Zu beachten: Für das Arbeiten mit den Strukturen der Zutrittslisten ist kein vorheriges Laden mit DFCLoadListenbeschreibung() nötig.

Parameter

[in] connectionNumber Zu verwendende Verbindungsnummer.

[in]

number

Listennummer.

Bereich	Bedeutung
0 bis DFCListBCnt() - 1	Nummer der Listenbeschreibung aus dem Setup
100 bis 103	Ab DFCom Version 02.00.22 für die Zutrittslisten Version 1 (z. B. 102 für Liste "Personalstamm") Offsetnummern der Listen siehe DFCMakeEntranceList()
200 bis 207	Ab DFCom Version 04.01.00 für die Zutrittslisten Version 2 (z. B. 203 für Liste "Time") Offsetnummern der Listen siehe DFCMakeEntrance2List()

[out] name Zeichenpuffer für den Namen. Muss mindestens 17 Zeichen lang sein.

[out] fieldCount Anzahl der Felder.

[out] unused_setTo0 Variable welche eine 0 erhält. Reservierter Parameter.

Rückgabewerte

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

◆ DFCListBFeld()

int DF_API_CALL DFCListBFeld	(	int	connectionNumber,
		int	listBNumber,
		int	number,
		char *	name,
		int *	type,
		int *	size
	)

Grunddaten eines Listenfeldes abrufen.

Auf Grundlage der zuvor mit DFCLoadListenbeschreibung() gelesenen Listentabellen, werden die Grunddaten zu einem Listenfeld zurückgegeben.

Export: DFComDLL als _DFCListBFeld@24
DFCom_x64 als DFCListBFeld

Zu beachten: Für das Arbeiten mit den Strukturen der Zutrittslisten ist kein vorheriges Laden mit DFCLoadListenbeschreibung() nötig.

Parameter

[in] connectionNumber Zu verwendende Verbindungsnummer.

[in]

listBNumber

Listennummer.

Bereich	Bedeutung
0 bis DFCListBCnt() - 1	Nummer der Listenbeschreibung aus dem Setup
100 bis 103	Ab DFCom Version 02.00.22 für die Zutrittslisten Version 1 (z. B. 102 für Liste "Personalstamm") Offsetnummern der Listen siehe DFCMakeEntranceList()
200 bis 207	Ab DFCom Version 04.01.00 für die Zutrittslisten Version 2 (z. B. 203 für Liste "Time") Offsetnummern der Listen siehe DFCMakeEntrance2List()

[in] number Feldnummer. Bereich 0 bis maximal 25.

[out] name Zeichenpuffer für den Feldnamen. Muss mindestens 17 Zeichen lang sein.

[out]

type

Datentyp.

Wert	Bedeutung
1	uint32 (4 Byte)
2	DateTime (7 Byte, 4 Byte Date, 3 Byte Time)
3	String (1-41 Byte, only digits [0-9])
4	String (1-41 Byte, Latin1 codec)
5	Date (4 Byte; Y100, Y, M, D)
6	Time (3 Byte; h, m, s)
7	Finger template (161 Byte; DIN V66400)
8	Finger template (216 Byte; Idencom Compact)
9	Binary data (1-220 Byte, Binär)
10	Daten (2-241 Byte, Binär)

[out] size Länge. Die Längenangabe beinhaltet ein eventuell benötigtes Nullterminierungszeichen bei Feldern für Zeichenfolgen.

Rückgabewerte

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

◆ DFCLoadListen()

int DF_API_CALL DFCLoadListen	(	int	connectionNumber,
		int	deviceAddress,
		int *	errorNumber
	)

Übertragen der bibliotheksinternen Datenpuffer zum Gerät.

Es werden die mit DFCMakeListe() importierten Listendaten in das Gerät geschrieben. Vorhandene Listendaten werden hierbei erst nach einer erfolgreichen Übernahme überschrieben.

Export: DFComDLL als _DFCLoadListen@12
DFCom_x64 als DFCLoadListen

Zu beachten: Für die Verarbeitung der Listendaten siehe Listen des Setups.

Achtung: Bitte beachten Sie die Hinweise zur Lebensdauer der eingesetzten Flash-Bausteine. Diese gelten ebenfalls für Zutrittslisten.

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[out]	errorNumber	Fehlernummer bei fehlerhafter Ausführung.

Rückgabewerte

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

◆ DFCLoadListenbeschreibung()

int DF_API_CALL DFCLoadListenbeschreibung	(	int	connectionNumber,
		int	deviceAddress,
		int *	errorNumber
	)

Aufbau der Listentabellen aus dem Geräte lesen.

Es werden die im Gerätesetup verwendeten Tabellenbeschreibungen für die Setuplisten in den Bibliotheksinternen Puffer gelesen. Hiernach kann mit den Funktionen DFCListBCnt(), DFCListBDatensatz() und DFCListBFeld() auf die ermittelten Daten zugegriffen werden.

Export: DFComDLL als _DFCLoadListenbeschreibung@12
DFCom_x64 als DFCLoadListenbeschreibung

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[out]	errorNumber	Fehlernummer bei fehlerhafter Ausführung.

Rückgabewerte

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

◆ DFCMakeListe()

int DF_API_CALL DFCMakeListe	(	int	connectionNumber,
		int	number,
		int	recordCount,
		int	size,
		const unsigned char *	buffer,
		int	unused_setTo0
	)

Kopieren eines aufbereiteten Datenarrays für eine Setupliste in den biblioteksinternen Datenpuffer.

Das zu übergebende Datenarray wird in den Bibliotheksinternen Datenpuffer kopiert und für eine spätere Übertragung mittels DFCLoadListen() zwischengespeichert.

Export: DFComDLL als _DFCMakeListe@24
DFCom_x64 als DFCMakeListe

Zu beachten: Für die Verarbeitung der Listendaten siehe Listen des Setups.; Für die Aufbereitung der Listendaten siehe Importieren von Listendaten.

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	number	Listennnummer.
[in]	recordCount	Anzahl der Datensätze im übergebenen Datenarray.
[in]	size	Anzahl Byte des Datenarrays. Brechnet sich aus (recordCount * Größe pro Datensatz).
[in]	buffer	Datenarray mit den Daten.
[in]	unused_setTo0	Sollte mit 0 übergeben werden. Reservierter Parameter.

Rückgabewerte

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