Datafox DFCom - API  04.03.11.00
Dokumentation zur Datafox Kommunikationsbibliothek (DFComDLL.dll / DFCom_x64.dll)
df_access_control_lists_v1.h-Dateireferenz
#include "df_defines.h"

gehe zum Quellcode dieser Datei

Funktionen

void DF_API_CALL DFCClearEntranceListBuffer (int connectionId, int number)
 Bibliotheksinterne Datenpuffer für Listendaten der Zutrittskontrolle löschen und initalisieren. Mehr ...
 
int DF_API_CALL DFCMakeEntranceList (int connectionId, int number, int recordCount, int size, const unsigned char *buffer, int *errorNumber)
 Kopieren eines aufbereiteten Datenarrays für Listendaten der Zutrittskontrolle in den Biblioteksinternen Datenpuffer. Mehr ...
 
int DF_API_CALL DFCLoadEntranceList (int connectionId, int deviceAddress, int number, int *errorNumber)
 Übertragen der bibliotheksinternen Datenpuffer zum Gerät. Mehr ...
 

Dokumentation der Funktionen

◆ DFCClearEntranceListBuffer()

void DF_API_CALL DFCClearEntranceListBuffer ( int  connectionId,
int  number 
)

Bibliotheksinterne Datenpuffer für Listendaten der Zutrittskontrolle 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 DFCMakeEntranceList() und DFCLoadEntranceList() initalisiert.

Export
DFComDLL als _DFCClearEntranceListBuffer@8
DFCom_x64 als DFCClearEntranceListBuffer
Warnung
Diese Funktion setzt eine Firmwareversion kleiner 04.01.00 vorraus.
Parameter
[in]connectionIdZu verwendende Verbindungs-Id.
[in]numberListennummer. Bei Angabe von -1 werden alle vorhandenen Listenpuffer initialisiert.
WertListenname
-1Alle Listen
0Zeitzonen
1Zeitmodelle
2Personalstamm
3Feiertage

◆ DFCLoadEntranceList()

int DF_API_CALL DFCLoadEntranceList ( int  connectionId,
int  deviceAddress,
int  number,
int *  errorNumber 
)

Übertragen der bibliotheksinternen Datenpuffer zum Gerät.

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

Export
DFComDLL als _DFCLoadEntranceList@16
DFCom_x64 als DFCLoadEntranceList
Warnung
Diese Funktion setzt eine Firmwareversion kleiner 04.01.00 vorraus.
Bitte beachten Sie die Hinweise zur Lebensdauer der eingesetzten Flash-Bausteine. Diese gelten ebenfalls für Zutrittslisten.
Zu beachten
Die Listen besitzen teilweise interne Bezüge zueinander. Um die Datenkonsistenz zu wahren müssen Sie sicherstellen, das bei hinzufügen neuer Datensätze die sich über mehrere Listen auswirken diese in einem Bundle übertragen werden.
Importieren Sie hierzu bitte alle zusammengehörenden Listen mittels DFCMakeEntrance2List und überragen diese dann mit mit dem Wert -1 für den Parameter number. Es wird dadurch sichergestellt, dass alle Listen erst übernommen werden, wenn die Überragung durchweg erfolgreich war.
Parameter
[in]connectionIdZu verwendende Verbindungs-Id.
[in]deviceAddressAnzusprechende Geräteadresse.
[in]numberListennummer. -1 Überträgt alle importierten Listendaten.
WertListenname
-1Alle mit DFCMakeEntranceListe importieren Listen
0Zeitzonen
1Zeitmodelle
2Personalstamm
3Feiertage
-1Alle importierten Listenpuffer
[out]errorNumberFehlernummer bei fehlerhafter Ausführung.
Rückgabewerte
0Fehler bei Ausführung.
1Ausführung war erfolgreich.

◆ DFCMakeEntranceList()

int DF_API_CALL DFCMakeEntranceList ( int  connectionId,
int  number,
int  recordCount,
int  size,
const unsigned char *  buffer,
int *  errorNumber 
)

Kopieren eines aufbereiteten Datenarrays für Listendaten der Zutrittskontrolle in den Biblioteksinternen Datenpuffer.

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

Export
DFComDLL als _DFCMakeEntranceList@24
DFCom_x64 als DFCMakeEntranceList
Warnung
Diese Funktion setzt eine Firmwareversion kleiner 04.01.00 vorraus.
Parameter
[in]connectionIdZu verwendende Verbindungs-Id.
[in]numberListennummer.
WertListennameGröße pro Datensatz in Bytemax. Datensätze
0Zeitzonen2216
1Zeitmodelle3532
2Personalstamm195120
3Feiertage1664
[in]recordCountAnzahl der Datensätze im übergebenen Datenarray.
[in]sizeAnzahl Byte des Datenarray.
Brechnet sich aus (recordCount * Größe pro Datensatz).
[in]bufferDatenarray mit den Daten.
[out]errorNumberFehlernummer bei fehlerhafter Ausführung.
Rückgabewerte
0Fehler bei Ausführung.
1Ausführung war erfolgreich.

© 2003-2018 Datafox GmbH