#include "df_defines.h"

Funktionen
int DF_API_CALL	DFCEntrance2Identification (int connectionNumber, int deviceAddress, const char readerTM, const char identificationId, const char identificationPin, char statusText, int statusTextLength, int errorNumber)
	Löst eine virtuelle Zutrittsbuchung in der Zutrittskontrolle des Gerätes aus.

int DF_API_CALL	DFCEntrance2OnlineAction (int connectionNumber, int deviceAddress, const char readerTM, int mask, int type, int duration, int errorNumber)
	Löst im Online-Modus der Zutrittskontrolle des Gerätes, eine Leser-Aktion durch.

int DF_API_CALL	DFCAccessControlIdentification (int connectionNumber, int deviceAddress, int masterId, const char readerTM, const char identificationId, const char identificationPin, char statusText, int statusTextLength, int errorNumber)
	Löst eine virtuelle Zutrittsbuchung in der Zutrittskontrolle des Gerätes aus.

int DF_API_CALL	DFCAccessControlOnlineAction (int connectionNumber, int deviceAddress, int masterId, const char readerTM, int mask, int type, int duration, int errorNumber)
	Löst im Online-Modus der Zutrittskontrolle des Gerätes, eine Leser-Aktion aus.

Dokumentation der Funktionen

◆ DFCAccessControlIdentification()

int DF_API_CALL DFCAccessControlIdentification	(	int	connectionNumber,
		int	deviceAddress,
		int	masterId,
		const char *	readerTM,
		const char *	identificationId,
		const char *	identificationPin,
		char *	statusText,
		int *	statusTextLength,
		int *	errorNumber
	)

Löst eine virtuelle Zutrittsbuchung in der Zutrittskontrolle des Gerätes aus.

Die Funktion lässt sich aus Sicherheitsgründen nur auf Ausweise anwenden die im Feld "ActiveGeneral" der Liste "Identification" entweder den Wert "2" oder "9" eingetragen haben.

Export: DFComDLL als _DFCAccessControlIdentification@36
DFCom_x64 als DFCAccessControlIdentification

Zu beachten: Nähere Informationen für die zu übergebenden Feldwerte (TM, Id, Pin) sowie den zurückgelieferten Status (statusText) entnehmen Sie bitte dem jeweilingen Handbuch aus dem Kapitel "Zutrittskontrolle" und Unterkapitel "Statusmeldungen".

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	masterId	Anzusprechende Master-Id. Diese entspricht dem Zutrittsbus bei Geräten mit mehreren Zutrittsstängen. Standardwert ist 1. Wertebereich 1 - 9999.
[in]	readerTM	Feldwert entsprechend des Feldes "TM" der Liste "Reader". Er muss demnach immer 3 Ziffern umfassen.
[in]	identificationId	Feldwert entsprechend des Feldes "Id" der Liste "Identification". Er darf maximal 20 Zeichen lang sein.
[in]	identificationPin	Feldwert entsprechend des Feldes "Pin" der Liste "Identification". Er darf maximal 8 Ziffern beinhalten.
[in]	statusText	Zeichenarray für den Status der Zutrittsprüfung. Sie sollten mindestens 5 Zeichen vorsehen.
[in,out]	statusTextLength	Als `in` die Länge des Arrays für statusText, als `out` die Länge der übergebenen Zeichenfolge.
[out]	errorNumber	Fehlernummer bei fehlerhafter Ausführung.

Rückgabewerte

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

Seit: 04.03.04 enthalten

◆ DFCAccessControlOnlineAction()

int DF_API_CALL DFCAccessControlOnlineAction	(	int	connectionNumber,
		int	deviceAddress,
		int	masterId,
		const char *	readerTM,
		int	mask,
		int	type,
		int	duration,
		int *	errorNumber
	)

Löst im Online-Modus der Zutrittskontrolle des Gerätes, eine Leser-Aktion aus.

Steuern des Buzzer, LED und Relais eines Zutrittslesers im Online-Modus der Zutrittskontrolle.

Export: DFComDLL als _DFCAccessControlOnlineAction@32
DFCom_x64 als DFCAccessControlOnlineAction

Parameter

[in] connectionNumber Zu verwendende Verbindungsnummer.

[in] deviceAddress Anzusprechende Geräteadresse.

[in] masterId Anzusprechende Master-Id. Diese entspricht dem Zutrittsbus bei Geräten mit mehreren Zutrittsstängen. Standardwert ist 1. Wertebereich 1 - 9999.

[in] readerTM Feldwert entsprechend des Feldes "TM" der Liste "Reader". Er muss demnach immer 3 Ziffern umfassen.

[in]

mask

Wert der anzusprechenden Komponenten. Als Ausgang kann je nach verwendetem Modul, ein Relais oder ein digitaler Ausgang vorliegen.

Bitnummer	Wert	Bedeutung
1	1	Buzzer
2	2	Grüne LED
3	4	Rote LED
4	8	Ausgang 1
5	16	Ausgang 2
6	32	Ausgang 3
7	64	Ausgang 4
8	128	Gelbe LED
9	256	Ausgang 5
10	512	Ausgang 6
11	1024	Ausgang 7
12	2048	Ausgang 8
13	4096	Ausgang 9
14	8192	Ausgang 10
15	16384	Ausgang 11
16	32768	Ausgang 12

Bitnummer	Wert	Bedeutung
17	65536	Ausgang 13
18	131072	Ausgang 14
19	262144	Ausgang 15
20	524288	Ausgang 16
21	1048576	Ausgang 17
22	2097152	Ausgang 18
23	4194304	Ausgang 19
24	8388608	Ausgang 20
25	16777216	Ausgang 21
26	33554432	Ausgang 22
27	67108864	Ausgang 23
28	134217728	Ausgang 24
29	268435456	Ausgang 25
30	536870912	Ausgang 26
31	1073741824	Ausgang 27
32	2147483648	Ausgang 28

Sie geben durch die gesetzten Bits an, welche Komponenten bei Ausführung angesprochen werden sollen.
Als Beispiel geben Sie für das ansprechen der Grünen LED und des 9 Relais (2 + 4096 =) 4098 als Wert an.

[in]

type

Anzunehmenden Zustand der gewählten Komponenten.

Wert	Bedeutung
0	Aus
1	Ein
2	Dauerhaft im Wechsel 600ms an, 600ms aus.
3	Drei mal im Wechsel 400ms an, 400ms aus

[in]

duration

Zusätzliche Zeitangabe bei Angabe von type = 1. Ansonsten wird der Wert ignoriert.

Wert	Bedeutung
0	Dauerhaft
1 bis 40	Anzahl Sekunden für den Zustand: Ein

[out] errorNumber Fehlernummer bei fehlerhafter Ausführung.

Rückgabewerte

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

Seit: 04.03.04 enthalten

◆ DFCEntrance2Identification()

int DF_API_CALL DFCEntrance2Identification	(	int	connectionNumber,
		int	deviceAddress,
		const char *	readerTM,
		const char *	identificationId,
		const char *	identificationPin,
		char *	statusText,
		int *	statusTextLength,
		int *	errorNumber
	)

Löst eine virtuelle Zutrittsbuchung in der Zutrittskontrolle des Gerätes aus.

Die Funktion lässt sich aus Sicherheitsgründen nur auf Ausweise anwenden die im Feld "ActiveGeneral" der Liste "Identification" entweder den Wert "2" oder "9" eingetragen haben.

Export: DFComDLL als _DFCEntrance2Identification@32
DFCom_x64 als DFCEntrance2Identification

Veraltet:: Bitte verwenden Sie wenn möglich DFCAccessControlIdentification(). Diese biedet Ihnen zusätzlich die Angabe eines speziellen Zutrittsbusses, wenn mehrere Zutrittsstränge verfügbar sein sollten.

Zu beachten: Nähere Informationen für die zu übergebenden Feldwerte (TM, Id, Pin) sowie den zurückgelieferten Status (statusText) entnehmen Sie bitte dem jeweilingen Handbuch aus dem Kapitel "Zutrittskontrolle" und Unterkapitel "Statusmeldungen".

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	readerTM	Feldwert entsprechend des Feldes "TM" der Liste "Reader". Er muss demnach immer 3 Ziffern umfassen.
[in]	identificationId	Feldwert entsprechend des Feldes "Id" der Liste "Identification". Er darf maximal 20 Zeichen lang sein.
[in]	identificationPin	Feldwert entsprechend des Feldes "Pin" der Liste "Identification". Er darf maximal 8 Ziffern beinhalten.
[in]	statusText	Zeichenarray für den Status der Zutrittsprüfung. Sie sollten mindestens 5 Zeichen vorsehen.
[in,out]	statusTextLength	Als `in` die Länge des Arrays von statusText, als `out` die Länge der übergebenen Zeichenfolge.
[out]	errorNumber	Fehlernummer bei fehlerhafter Ausführung.

Rückgabewerte

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

Seit: 04.01.04 enthalten

◆ DFCEntrance2OnlineAction()

int DF_API_CALL DFCEntrance2OnlineAction	(	int	connectionNumber,
		int	deviceAddress,
		const char *	readerTM,
		int	mask,
		int	type,
		int	duration,
		int *	errorNumber
	)

Löst im Online-Modus der Zutrittskontrolle des Gerätes, eine Leser-Aktion durch.

Steuern des Buzzer, LED und Relais eines Zutrittslesers im Online-Modus der Zutrittskontrolle.

Export: DFComDLL als _DFCEntrance2OnlineAction@28
DFCom_x64 als DFCEntrance2OnlineAction

Veraltet:: Bitte verwenden Sie wenn möglich DFCAccessControlOnlineAction(). Diese biedet Ihnen zusätzlich die Angabe eines speziellen Zutrittsbusses, wenn mehrere Zutrittsstränge verfügbar sein sollten.

Parameter

[in] connectionNumber Zu verwendende Verbindungsnummer.

[in] deviceAddress Anzusprechende Geräteadresse.

[in] readerTM Feldwert entsprechend des Feldes "TM" der Liste "Reader". Er muss demnach immer 3 Ziffern umfassen.

[in]

mask

Wert der anzusprechenden Komponenten. Als Ausgang kann je nach verwendetem Modul, ein Relais oder ein digitaler Ausgang vorliegen.

Bitnummer	Wert	Bedeutung
1	1	Buzzer
2	2	Grüne LED
3	4	Rote LED
4	8	Ausgang 1
5	16	Ausgang 2
6	32	Ausgang 3
7	64	Ausgang 4
8	128	Gelbe LED
9	256	Ausgang 5
10	512	Ausgang 6
11	1024	Ausgang 7
12	2048	Ausgang 8
13	4096	Ausgang 9
14	8192	Ausgang 10
15	16384	Ausgang 11
16	32768	Ausgang 12

Bitnummer	Wert	Bedeutung
17	65536	Ausgang 13
18	131072	Ausgang 14
19	262144	Ausgang 15
20	524288	Ausgang 16
21	1048576	Ausgang 17
22	2097152	Ausgang 18
23	4194304	Ausgang 19
24	8388608	Ausgang 20
25	16777216	Ausgang 21
26	33554432	Ausgang 22
27	67108864	Ausgang 23
28	134217728	Ausgang 24
29	268435456	Ausgang 25
30	536870912	Ausgang 26
31	1073741824	Ausgang 27
32	2147483648	Ausgang 28

Sie geben durch die gesetzten Bits an, welche Komponenten bei Ausführung angesprochen werden sollen.
Als Beispiel geben Sie für das ansprechen der Grünen LED und des 9 Relais (2 + 4096 =) 4098 als Wert an.

[in]

type

Anzunehmenden Zustand der gewählten Komponenten.

Wert	Bedeutung
0	Aus
1	Ein
2	Dauerhaft im Wechsel 600ms an, 600ms aus.
3	Drei mal im Wechsel 400ms an, 400ms aus

[in]

duration

Zusätzliche Zeitangabe bei Angabe von type = 1. Ansonsten wird der Wert ignoriert.

Wert	Bedeutung
0	Dauerhaft
1 bis 40	Anzahl Sekunden für den Zustand: Ein

[out] errorNumber Fehlernummer bei fehlerhafter Ausführung.

Rückgabewerte

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

Seit: 04.01.05 enthalten