gehe zum Quellcode dieser Datei
|
int DF_API_CALL | DFCSetupLaden (int connectionId, int deviceAddress, const char *filePath, int *errorNumber) |
| Schreiben einer Setupdatei (*.aes; *.ael). Mehr ...
|
|
int DF_API_CALL | DFCDownload (int connectionId, int deviceAddress, const char *filePath, int *errorNumber) |
| Lesen einer Setupdatei (*.aes; *.ael). Mehr ...
|
|
int DF_API_CALL | DFCModifyStudioFile (const char *sourceFilePath, const char *destFilePath, const char *xmlData, int flags, int *errorNumber) |
| Verändern von Setupdateien aufgrund einer Vorlagedatei (*.aes; *.ael). Mehr ...
|
|
int DF_API_CALL | DFCUpload (int connectionId, int deviceAddress, const char *filePath, int *errorNumber) |
| Schreiben von Gerätedateien (Firmwareupdates) zum Gerät. Mehr ...
|
|
int DF_API_CALL | DFCFileUpload (int connectionId, int deviceAddress, int fileType, const char *filePath, int flags, int *errorNumber) |
| Schreiben von Dateidaten zum Gerät. Mehr ...
|
|
int DF_API_CALL | DFCFileDownload (int connectionId, int deviceAddress, int fileType, const char *filePath, int flags, int *errorNumber) |
| Lesen von Dateidaten vom Gerät. Mehr ...
|
|
int DF_API_CALL | DFCUploadModule (int connectionId, int deviceAddress, int fileType, const char *filePath, int *errorNumber) |
| Schreiben von Modulupdates zum Gerät. Mehr ...
|
|
◆ DFCDownload()
int DF_API_CALL DFCDownload |
( |
int |
connectionId, |
|
|
int |
deviceAddress, |
|
|
const char * |
filePath, |
|
|
int * |
errorNumber |
|
) |
| |
Lesen einer Setupdatei (*.aes; *.ael).
Die im Gerät enthaltene Setupdatei wird ausgelesen und in der angegebenen Datei gespreichert.
- Export
- DFComDLL als
_DFCDownload@16
DFCom_x64 als DFCDownload
- Warnung
- Eine ggf. vorhandene Datei kann durch die auszulesende überschrieben werden.
- Parameter
-
[in] | connectionId | Zu verwendende Verbindungs-Id. |
[in] | deviceAddress | Anzusprechende Geräteadresse. |
[in] | filePath | Dateiname der zu speichernden Setupdatei mit einer der Endungen *.aes oder *.ael. |
[out] | errorNumber | Fehlernummer bei fehlerhafter Ausführung. |
- Rückgabewerte
-
0 | Fehler bei Ausführung. |
1 | Ausführung war erfolgreich. |
◆ DFCFileDownload()
int DF_API_CALL DFCFileDownload |
( |
int |
connectionId, |
|
|
int |
deviceAddress, |
|
|
int |
fileType, |
|
|
const char * |
filePath, |
|
|
int |
flags, |
|
|
int * |
errorNumber |
|
) |
| |
Lesen von Dateidaten vom Gerät.
Liest die Daten der angegebenen Datei unter dem angegebenen Dateinamen aus dem Gerät. Schreiben von Dateidaten erfolgt mit der Funktion DFCFileUpload().
- Export
- DFComDLL als
_DFCFileDownload@24
DFCom_x64 als DFCFileDownload
- Parameter
-
[in] | connectionId | Zu verwendende Verbindungs-Id. |
[in] | deviceAddress | Anzusprechende Geräteadresse. |
[in] | fileType | Typ der zu lesenden Dateidaten.
Wert | Bedeutung |
-1 | Dateityp wird an der Namensendung erkannt. |
0 | Nur Schreiben möglich. Datei mit Textdaten der Firmware. Endung *.dfl |
1 | Nur Schreiben möglich. Datei mit Touchtastendefinitionen des Touch. Endung *.dfk |
2 | Nur Schreiben möglich. Datei mit Farbeinstellungen für TimeboyIV. Endung *.dfc |
3 | Datei mit LAN / WLAN Konfigurationsdaten. Endung *.df0 |
4 | Dateiangabe. Endung (*.*) |
|
[in] | filePath | Dateiname. |
[in] | flags | Reservierter Parameter. Standardwert 0. |
[out] | errorNumber | Fehlernummer bei fehlerhafter Ausführung. |
- Rückgabewerte
-
0 | Fehler bei Ausführung. |
1 | Ausführung war erfolgreich. |
◆ DFCFileUpload()
int DF_API_CALL DFCFileUpload |
( |
int |
connectionId, |
|
|
int |
deviceAddress, |
|
|
int |
fileType, |
|
|
const char * |
filePath, |
|
|
int |
flags, |
|
|
int * |
errorNumber |
|
) |
| |
Schreiben von Dateidaten zum Gerät.
Schreibt die Daten der angegebenen Datei unter dem angegebenen Dateinamen in das Gerät. Je nach Dateityp kann diese ggf. später mit DFCFileDownload() wieder ausgelesen werden.
- Export
- DFComDLL als
_DFCFileUpload@24
DFCom_x64 als DFCFileUpload
- Warnung
- Diese Funktion ist nicht dafür gedacht Anwenderdateien auf dem Gerät abzulegen. Unbekannte Dateien werden bei Bedarf von der Firmware gelöscht. Ggf. kann es durch eine Unsachgemäße Verwendung zu Problemen bei der Übernahme von Listendaten u. a. kommen.
- Parameter
-
[in] | connectionId | Zu verwendende Verbindungs-Id. |
[in] | deviceAddress | Anzusprechende Geräteadresse. |
[in] | fileType | Typ der zu schreibenden Dateidaten.
Wert | Bedeutung |
-1 | Dateityp wird an der Namensendung erkannt. |
0 | Datei mit Textdaten der Firmware. Endung *.dfl |
1 | Datei mit Touchtastendefinitionen des Touch. Endung *.dfk |
2 | Datei mit Farbeinstellungen für TimeboyIV. Endung *.dfc |
3 | Datei mit LAN / WLAN Konfigurationsdaten. Endung *.df0 |
4 | Dateiangabe. Endung (*.*) |
|
[in] | filePath | Dateiname. |
[in] | flags | Reservierter Parameter. Standardwert 0. |
[out] | errorNumber | Fehlernummer bei fehlerhafter Ausführung. |
- Rückgabewerte
-
0 | Fehler bei Ausführung. |
1 | Ausführung war erfolgreich. |
◆ DFCModifyStudioFile()
int DF_API_CALL DFCModifyStudioFile |
( |
const char * |
sourceFilePath, |
|
|
const char * |
destFilePath, |
|
|
const char * |
xmlData, |
|
|
int |
flags, |
|
|
int * |
errorNumber |
|
) |
| |
Verändern von Setupdateien aufgrund einer Vorlagedatei (*.aes; *.ael).
Übertragen der notwendigen Gerätedaten die aus Zeichensatz-, Grafik-, Textdaten sowie Firmware bestehen und zusammen in einer Datei der Endung *.hex oder in einem Archiv der Endung *.dfz vorliegen.
- Export
- DFComDLL als
_DFCModifyStudioFile@20
DFCom_x64 als DFCModifyStudioFile
- Zu beachten
- Zur Funktion liegt ein eigenes Dokument auf der Produkt-DVD.
- Parameter
-
[in] | sourceFilePath | Dateiname der Setupdatei die als Template dient. |
[in] | destFilePath | Dateiname der modifizierten Setupdatei, welche dann in das Gerät übertragen werden soll. |
[in] | xmlData | Datenfragment oder Dateiname einer Datei welche die Informationen zum Modifizieren enthält. |
[in] | flags | Reservierter Parameter. Standardwert 0. |
[out] | errorNumber | Fehlernummer bei fehlerhafter Ausführung. |
- Rückgabewerte
-
0 | Fehler bei Ausführung. |
1 | Ausführung war erfolgreich. |
- Beispiel für xmlData.
<?xml version="1.0" ?>
<modify>
<password>
<system>
<value>1234</value>
</system>
<user>
<value>2345</value>
</user>
<menu_item>
<name>MEID_003</name>
<value>4711</value>
</menu_item>
</password>
<fingerprint>
<security_level>20</security_level>
<image_quality>70</image_quality>
<minutiae_count>20</minutiae_count>
</fingerprint>
<replace>
<name>
<search>MID_001</search>
<replacement>PZE Setup</replacement>
</name>
<name>
<search>MEID_001</search>
<replacement>Kommt:</replacement>
</name>
<name>
<search>MEID_002</search>
<replacement>Geht:</replacement>
</name>
<name>
<search>MEID_003</search>
<replacement>Abwesend</replacement>
</name>
</replace>
</modify>
◆ DFCSetupLaden()
int DF_API_CALL DFCSetupLaden |
( |
int |
connectionId, |
|
|
int |
deviceAddress, |
|
|
const char * |
filePath, |
|
|
int * |
errorNumber |
|
) |
| |
Schreiben einer Setupdatei (*.aes; *.ael).
Die Setupdatei (*.aes; *.ael) wird auf das Gerät übertragen. Danach müssen ggf. die Listen neu übertragen werden. Ebenfalls ggf. die Zutrittslisten oder Timeboylisten.
- Zu beachten
- Es dürfen sich keine abrufbare Datensätze mehr auf dem Gerät befinden. Rufen Sie diese zuvor mit DFCReadRecord() ab oder wenn sie nicht mehr benötigt werden, dann können Sie diese mit DFCComClearData() löschen.
- Export
- DFComDLL als
_DFCSetupLaden@16
DFCom_x64 als DFCSetupLaden
- Parameter
-
[in] | connectionId | Zu verwendende Verbindungs-Id. |
[in] | deviceAddress | Anzusprechende Geräteadresse. |
[in] | filePath | Dateiname der zu übertragenden Setupdatei mit einer der Endungen *.aes oder *.ael. |
[out] | errorNumber | Fehlernummer bei fehlerhafter Ausführung. |
- Rückgabewerte
-
0 | Fehler bei Ausführung. |
1 | Ausführung war erfolgreich. |
◆ DFCUpload()
int DF_API_CALL DFCUpload |
( |
int |
connectionId, |
|
|
int |
deviceAddress, |
|
|
const char * |
filePath, |
|
|
int * |
errorNumber |
|
) |
| |
Schreiben von Gerätedateien (Firmwareupdates) zum Gerät.
Übertragen der notwendigen Gerätedaten die aus Zeichensatz-, Grafik-, Textdaten sowie Firmware bestehen und zusammen in einer Datei der Endung *.hex oder in einem Archiv der Endung *.dfz vorliegen.
- Export
- DFComDLL als
_DFCUpload@16
DFCom_x64 als DFCUpload
- Zu beachten
- Unter Unix-Systemen ist bei Verwendung eines Archives *.dfz dieses vor der Übertragung zu entpacken und beim Aufruf der Funktion das Verzeichnis anzugeben.
- Parameter
-
[in] | connectionId | Zu verwendende Verbindungs-Id. |
[in] | deviceAddress | Anzusprechende Geräteadresse. |
[in] | filePath | Dateiname der Gerätedatei (*.dfz; *.hex). |
[out] | errorNumber | Fehlernummer bei fehlerhafter Ausführung. |
- Rückgabewerte
-
0 | Fehler bei Ausführung. |
1 | Ausführung war erfolgreich. |
◆ DFCUploadModule()
int DF_API_CALL DFCUploadModule |
( |
int |
connectionId, |
|
|
int |
deviceAddress, |
|
|
int |
fileType, |
|
|
const char * |
filePath, |
|
|
int * |
errorNumber |
|
) |
| |
Schreiben von Modulupdates zum Gerät.
Schreibt die Updatedaten zu verbauten Modulen auf das Gerät. Im Gerät verbaute Module haben teilweise eine eigene updatefähige Firmware. Durch diese Funktion können entsprechende Updatedateien übertragen werden, die dann durch die Gerätefirmware auf die verbauten Module übertragen wird.
- Export
- DFComDLL als
_DFCUploadModule@20
DFCom_x64 als DFCUploadModule
- Zu beachten
- Ein Updatevorgang kann durch Verwendung von DFCGetInfo() überprüft werden.
- Parameter
-
[in] | connectionId | Zu verwendende Verbindungs-Id. |
[in] | deviceAddress | Anzusprechende Geräteadresse. |
[in] | fileType | Typ der zu schreibenden Dateidaten.
Wert | Bedeutung |
0 | Firmwareupdate für Biokey von Idencom. Endungen *.up3, *.up4, *.up5 |
|
[in] | filePath | Dateiname. |
[out] | errorNumber | Fehlernummer bei fehlerhafter Ausführung. |
- Rückgabewerte
-
0 | Fehler bei Ausführung. |
1 | Ausführung war erfolgreich. |