df_access_control_lists_v1.h-Dateireferenz

#include "df_defines.h"

gehe zum Quellcode dieser Datei

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

Dokumentation der Funktionen

DFCClearEntranceListBuffer()

void DF_API_CALL DFCClearEntranceListBuffer	(	int	connectionNumber,
		int	listNumber
	)

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]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	listNumber	Listennummer. Bei Angabe von -1 werden alle vorhandenen Listenpuffer initialisiert. Wert Listenname -1 Alle Listen 0 Zeitzonen 1 Zeitmodelle 2 Personalstamm 3 Feiertage

DFCLoadEntranceList()

int DF_API_CALL DFCLoadEntranceList	(	int	connectionNumber,
		int	deviceAddress,
		int	listNumber,
		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]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	listNumber	Listennummer. -1 Überträgt alle importierten Listendaten. Wert Listenname -1 Alle mit DFCMakeEntranceListe importieren Listen 0 Zeitzonen 1 Zeitmodelle 2 Personalstamm 3 Feiertage
[out]	errorNumber	Fehlernummer bei fehlerhafter Ausführung.

Rückgabewerte

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

DFCMakeEntranceList()

int DF_API_CALL DFCMakeEntranceList	(	int	connectionNumber,
		int	listNumber,
		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]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	listNumber	Listennummer. Wert Listenname Größe pro Datensatz in Byte max. Datensätze 0 Zeitzonen 22 16 1 Zeitmodelle 35 32 2 Personalstamm 19 5120 3 Feiertage 16 64
[in]	recordCount	Anzahl der Datensätze im übergebenen Datenarray.
[in]	size	Anzahl Byte des Datenarray. Brechnet sich aus (recordCount * Größe pro Datensatz).
[in]	buffer	Datenarray mit den Daten.
[out]	errorNumber	Fehlernummer bei fehlerhafter Ausführung.

Rückgabewerte

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