gehe zum Quellcode dieser Datei
|
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.
|
|
◆ 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()
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. |