Datafox DFCom - API 04.03.21
Dokumentation zur Datafox Kommunikationsbibliothek (DFComDLL.dll / DFCom_x64.dll)
Fehlernummern

Die meisten Funktionen bieten eine Fehlerauswertung über das Error Argument nach folgender Tabelle, nachdem sie mit einer "if (DFCxxx == 0)" Abfrage gescheitert sind. Aktuell steht mit der Funktion DFCGetLastErrorNumber() eine Funktion zur Ermittlung des zuletzt aufgetretenen Fehlers zur Verfügung.

Folgende Fehlernummern können im Error-Parameter oder als Rückgabewert von DFCGetLastErrorNumber() auftreten:

Nummer (errorNumber) Bedeutung
0 Kein Fehler angegeben.
1 CRC (Prüfsumme) von Daten falsch.
2 Serielle Schnittstelle kann nicht geöffnet werden, z.B.: belegt durch anderes Programm oder bereits geöffnet.
3 Die Verbindungs-Id ist für die benötigte Kommunikation noch nicht initalisiert worden.
4 Allgemeiner Fehler während der Kommunikation.
5 Gerät antwortet nicht auf die Anfragen.
6 Fehler beim Senden eingetreten.
7 Fehler beim Empfangen eingetreten.
8 Antwort vom falschen Gerät oder im Kontext nicht sinnvoll.
9 Die verwendete Geräteadresse ist ungültig. Wertebereich: (1 - 250, 254)
10 Verbindungsobjekt nicht vorhanden. Verbindungsobjekt nicht erstellbar. Wertebereich: (1 - 391)
11 Öffnen einer Datei gescheitert. Meist nicht vorhanden.
12 Falsches Format der Setupdaten. Meist bezieht sich dies auf das Setup.
13 Fehler bei Verarbeitung der Listendaten.
14 Firmwareversion vom anzusprechenden Gerät ist nicht Kompatible.
15 Es sind noch Datensätze im Gerät vorhanden, welche unbrauchbar würden.
16 Befehlsausführung wurde durch Anwender abgebrochen.
17 Es ist keine Datensatzbeschreibung in dem Verbindungsobjekt geladen.
18 Es ist keine Listenbeschreibung in dem Verbindungsobjekt geladen.
19 Fehler beim Programmieren des Flash, Firmware.
20 Parameter einer Funktion außerhalb ihres Gültigkeitsbereiches.
21 Globale Variable nicht definiert.
22 Anfrage obwohl keine Daten.
23 Duplikat von Datensätzen abgefangen.
24 Gerätedatei nicht mit Bootloaderversion kompatible.
25 Firmwaredatei nicht mit Bootloaderversion kompatible.
26 Der verwendete Variablenwert ist zu lang.
27 Funktion steht im vorliegenden Fall nicht zur Verfügung.
28 Fehler in Anwendungsschicht bei Befehlsausführung. (Der Befehl wurde erfolgreich zwischen dem Gerät und der Bibliothek übertragen, die geforderte Ausführung konnte jedoch nicht erfolgen. z. B. unterstützt das Gerät die geforderte Funktion nicht oder ist augenblicklich nicht bereit die Funktion auszuführen.)
29 Der Gerätetyp ist unbekannt. Update der Software erforderlich.
30 Die angegebene Geraetedatei stimmt nicht mit der vorliegenden Hardware ueberein. Oder aber, es liegt keine passende Gerätedatei für die vorliegende Hardware im Zip-Archiv vor. Kommt bei DFCUpload zur Anwendung.
31 Gerätetyp stimmt nicht, z.B. versuchtes Einspielen von Setupdatei für PZE-MasterIV in AE-MasterIV
32 Die vorliegende Dateiendung wird nicht unterstützt.
33 Der Tabellenname oder Spaltenname ist undefiniert.
34 Ein angegebener Handle ist nicht gültig.
35 Der anzuwendende Filter würde keine Datensätze liefert.
36 Sprung führte zum Anfang der Tabelle. (Base of File)
37 Sprung führte zum Ende der Tabelle. (End of File)
38 Der angegebene Wert ist Fehlerhaft.
39 Die Zutrittskontrolle ist deaktiviert.
40 Bei einer Datenübertragung ist ein Speicherüberlauf eingetreten.
41 Es liegen keine Daten vor.
42 Der Befehl konnte zwar übermittelt werden, bei den Daten liegt jedoch ein Fehler vor.
43 Das angesprochene Modul ist zur Zeit durch einen anderen Prozess blockiert.
44 Fehler beim Laden einer XML-Datei.
45 Unbekannte Elemente in einer XML-Datei.
46 Fehlerhafter Dateninhalt einer XML-Datei.
47 Fehler beim Übernehmen oder Anwenden der Daten.
48 Speicherallokation konnte nicht durchgefuehrt werden.
49 Diese Version der Gerätedatei kann aufgrund ihrer Aktualität nicht verarbeitet werden.
50 Bei der Verarbeitung der Dateidaten trat ein Fehler auf.
51 Die vorliegende Gerätedatei passt nicht zur vorliegenden Hardware. Oder aber: Im Archiv wurde keine passende Gerätedatei gefunden.
52 Fehler beim Laden der Gerätedatei(archive) aufgetreten.
53 Der Active-Mode ist gestartet.
54 Der Active-Mode ist nicht gestartet.
55 Der angegebene Listensocket ist bereits in Verwendung.
56 Die Meldung von Datenätzen im Active-Mode ist deaktiviert.
57 Allgemeiner Fehler beim Starten des Active-Mode.
58 Das angegebene Passwort stimmt nicht mit dem benötigten überein. Es wird ein Passwort gefordert.
59 Gerät ist aufgrund von fehlerhaften Passworteingaben für 60 Sekunden gesperrt.
60 Das Schreiben in die Datei ist fehlgeschlagen.
61 Das Lesen aus der Datei ist fehlgeschlagen.
62 Fehlerhafter Dateninhalt. Die Prüfung auf die Datenkonsistenz per CRC schlug fehl.
63 Es steht kein weiterer Speicherplatz zur Verfügung. Z. B. kann die maximale aufnehmbare Anzahl Fingertemplates erreicht sein.
64 Die in der Datei vorliegenden Daten stimmen nicht mit den geforderten überein. Z. B. in der Datei liegen Fingertemplates vom Typ Idencom-Compact vor, es werden jedoch DIN Erfordert.
65 Es steht nicht genügend Flash-Speicher zur Verfügung, um die Daten aufzunehmen.
66 Das von Ihnen angesprochene Modul ist eine Optionale Hardware-Erweiterung und ist im vorliegenden Gerät nicht verfügbar.
67 In der Setupdatei werden Erweiterungen verwendet, die einen aktuelleren Firmwarestand voraussetzen.
68 Die abzuarbeitende Aufgabe wird durch die vorliegenden Firmwareversion nicht unterstuetzt.
69 Die abzuarbeitende Aufgabe wird durch die vorliegenden Gerätekonfiguration nicht unterstuetzt.
73 Dockingstation kommuniziert aktuell mit einem Timeboy und kann die Anfrage nicht weiterleiten.
74 Es ist kein Timeboy im Slot verfügbar.
75 Variante des Timeboy's wird noch ermittelt.
76 Es wird versucht einen TimeboyIV über das TimeboyI-III Protokoll anzusprechen.
77 Bei dem angesprochenen Timeboy handelt es sich um kein Model der MasterIV Reihe.
78 Die angesprochene DeviceID ist kein Slot einer Timeboystation.
80 Die Setupdatei setzt eine nicht erreichte Mindestversion der Bibliothek voraus.
81 Die Setupdatei gibt eine nicht erreichte Soll-Version der Bibliothek vor.
82 Die Setupdatei wird von der vorliegenden Firmwareversion 04.01.xx nicht unterstuetzt.
83 Die Setupdatei setzt eine nicht erreichte Mindestversion der Firmware 04.01.xx voraus.
84 Die Setupdatei gibt eine nicht erreichte, jedoch empfohlene, Firmwareversion 04.01.xx vor.
85 Die Setupdatei wird von der vorliegenden Firmwareversion 04.02.xx nicht unterstuetzt.
86 Die Setupdatei setzt eine nicht erreichte Mindestversion der Firmware 04.02.xx voraus.
87 Die Setupdatei gibt eine nicht erreichte, jedoch empfohlene, Firmwareversion 04.02.xx vor.
88 Das Gerät erfordert eine verschlüsselte Kommunikation, es wird das Passwort benötigt (DFCSetCommunicationPassword).
89 Die Setupdatei wird von der vorliegenden Firmwareversion 04.03.xx nicht unterstützt.
90 Die Setupdatei setzt eine nicht erreichte Mindestversion der Firmware 04.03.xx voraus.
91 Die Setupdatei gibt eine nicht erreichte, jedoch empfohlene, Firmwareversion 04.03.xx vor.
101 Die Ausführung einer Blockübertragung wurde aufgrund der vorgegebenen Zeitüberschreitung unterbrochen.
102 Durchführung unmöglich da aktuell eine laufende Blockübertragung vorliegt.
103 Durchführung unmöglich da aktuell keine laufende Blockübertragung vorliegt.
110 Das Fingerprintmodul bringt einen nicht näher spezifizierten Fehler.
111 Die Datenbank des Fingerprintmoduls ist voll.
112 Das Fingerprintmodul enthält keine Fingertemplates.
113 Das Fingertemplate existiert bereits.
114 Das angeforderte Fingertemplate existiert nicht.
120 Der verwendete Variablentype würde nicht eingehalten.
121 Das Schreib-/Leserecht würde nicht eingehalten.
122 Das verwendete Format oder der Wertebereich würde nicht eingehalten.
123 Die angeforderte Datei existiert nicht.
124 Die angeforderte Datei wird aktuell noch erstellt.
125 Das anzusprechende Hardwaremodul (Zutrittsbus) ist nicht vorhanden. In Verbindung mit DFCGetInfo()
126 Kein U&Z Funkmodul im Zutrittsbus vorhanden. In Verbindung mit DFCGetInfo()

Zusätzliche Hinweise zur Fehlerursache.

Gerät antwortet nicht auf die Anfragen.

  • Handelt es sich um einen Timeboy, sollten Sie darauf achten, folgende Mindest-Timeouts zu verwenden. Seriell min. 3000ms, TCP/IP min. 5000ms. Da gerade bei der Übertragung größerer Datenmengen wie beispielsweise Listen eine erhöhte interne Verarbeitungszeit anfällt, kann bei einem zu klein gewähltem Timeout die Kommunikation unterbrochen werden.

© 2003-2023 Datafox GmbH